dummy-link

Vega

A Julia package for generating visualizations in Vega

First Commit

06/25/2013

Last Touched

13 days ago

Commit Count

296 commits

Readme

Vega.jl

OSX/Linux: Build Status
pkg.julialang.org: Vega
Windows 64-bit: Build status

NOTE: THIS PACKAGE IS IN A STATE OF LIMBO

Vega.jl works for version 0.5; Vega.jl will not be updated to support Julia version 0.6 until the library is migrated to support Vega 3, which modified the majority of the JavaScript API. -- Randy, 4/11/2017

Introduction

A Julia package for creating Vega visualizations. Convenience functions for common visualizations are provided, while also allowing for unlimited customization through modification of the main VegaVisualization composite type.

At a high-level, Vega.jl is designed to provide an easy-to-use library to quickly make common visualizations, while also including some of the interactivity provided as part of the Vega 2.x JavaScript library. This package also provides a declarative syntax that deviates from Grammar-of-Graphics style packages.

This package is unrelated to VegaLite.jl, other than to have the same underlying vega JavaScript engine. Perhaps that will change in the future as cross-package efficiencies become more obvious!

Installation

Pkg.add("Vega")
using Vega

Using Vega from the REPL/Atom will work with or without an Internet connection, as the required JavaScript libraries are injected into the HTML before the browser is opened (automatically).

In order to use Jupyter Notebook offline, you will need to set up a shortcut/softlink to the Julia libraries named vegajl; for example, to serve notebooks from the folder ijulia_notebooks on OSX, run the following at the OSX Terminal (substituting the proper directory links of course):

ln -s /Users/randyzwitch/.julia/v0.4/Vega /Users/randyzwitch/ijulia_notebooks/vegajl

Documentation

Please see the documentation, which is rendered on-the-fly using Vega code generated from Vega.jl

TODO/Contributing

GitHub issues has a To-Do list of visualizations and open bugs/feature requests; of course, any contribution is welcomed!