vega-view: Easily view Vega or Vega-Lite visualizations.

[ bsd3, program, visualization ] [ Propose Tags ] [ Report a vulnerability ]

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

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 6649 total (29 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.

A Vega-Lite specification being dragged from a file browser and dropped onto the index page of the vega-view web server

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.