vega-view: Easily view Vega or Vega-Lite visualizations.
A web server that is used to view all the Vega and Vega-Lite specifications in a directory, or sub-directory. It is similar in overall scope to the vega destkop tool. Please see the README on GitHub at https://github.com/DougBurke/vega-view#vega-view
[Skip to Readme]
Downloads
- vega-view-0.4.0.1.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
| Versions [RSS] | 0.1.0.0, 0.2.0.0, 0.2.0.1, 0.2.0.2, 0.3.0.0, 0.3.0.1, 0.3.0.2, 0.3.0.3, 0.3.0.4, 0.3.0.5, 0.3.1.0, 0.3.1.1, 0.3.1.2, 0.3.1.3, 0.3.1.4, 0.3.1.5, 0.3.1.6, 0.3.1.7, 0.4.0.0, 0.4.0.1 |
|---|---|
| Change log | ChangeLog.md |
| Dependencies | aeson (>=1.1 && <2.3), base (>=4.9 && <5), blaze-html (>=0.7 && <0.10), blaze-markup (>=0.6 && <0.9), bytestring (>=0.10 && <0.13), directory (>=1.2.5.0 && <1.4), filepath (>=1.4 && <1.6), http-types (>=0.9 && <0.13), scotty (>=0.11 && <0.23), text (>=1.2 && <2.2), unordered-containers (>=0.2 && <0.3) [details] |
| License | BSD-3-Clause |
| Copyright | 2019, 2020, 2021, 2024 Douglas Burke |
| Author | Douglas Burke |
| Maintainer | dburke.gw@gmail.com |
| Category | Visualization |
| Home page | https://github.com/DougBurke/vega-view#vega-view |
| Bug tracker | https://github.com/DougBurke/vega-view/issues |
| Source repo | head: git clone https://github.com/DougBurke/vega-view |
| Uploaded | by DouglasBurke at 2024-06-03T13:15:12Z |
| Distributions | |
| Executables | vegaview |
| Downloads | 6655 total (30 in the last 30 days) |
| Rating | 2.0 (votes: 1) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs not available [build log] Last success reported on 2024-06-03 [all 1 reports] |
Readme for vega-view-0.4.0.1
[back to package description]vega-view
I am not 100% convinced this is a worthwhile project, but let's see how it goes. You can think of it as "I want vega desktop but don't want to install an electron application, so decided to write an inferior product" project.
The aim is to make it easy to view Vega and Vega-Lite specifications - i.e. the JSON representing a visualization - as a visualization. It relies on Vega Embed to do all the hard work, and just provides a basic web server that:
-
you can drag-and-drop files onto to view them;
-
and will list the files in a given directory and, when selected, view them inline or on a separate page.
License
This is released under a BSD3 license.
Usage
The server - called vega-view - should be run from the directory
containing the specifications to view. It then provides a web server
on port 8082 (unless the PORT environment variable is set, in
which case this value is used instead) that can be used to view them
at the URLs
http://localhost:8082/
http://localhost:8082/display/
(where 8082 should be replaced by the value of $PORT if set).
The first page lets you drag-and-drop files onto the page to view them. Thse second lets you browse the visualizations that are present in the diectory where you started the application. Thse can either be viewed as their own "page", or inline, which may be more useful when you have multiple plots to view.
The aim is to be run in a a directory structure where most, if not all, the files are Vega or Vega-Lite specifications. This means that the web server tries to parse each file as JSON, which could cause memory- or time- issues if there are large non-JSON files in the directory tree.
Specifications should have filenames ending in .vg.json, to
distinguish them from local data files.
GHC support
This is currently a very basic application, so will hopefully build against a wide variety of GHC installations. There has been /limited/ testing on Windows (it builds is as far as I've got).
Bugs and Issues
Please use the issues list to report any problems.