Skip to content

DougBurke/vega-view

Repository files navigation

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.

About

Webserver to make it easy to view Vega and Vega-Lite visualizations

Resources

License

Stars

Watchers

Forks

Packages

No packages published