search

queryverse / VegaLite.jl

Julia bindings to Vega-Lite
Other
268 stars 39 forks source link

readme

VegaLite.jl

Julia bindings to Vega-Lite

Project Status: Active - The project has reached a stable, usable state and is being actively developed. Build Status Build status codecov

Overview

VegaLite.jl is a plotting package for the julia programming language. The package is based on Vega-Lite, which extends a traditional grammar of graphics API into a grammar of interactive graphics.

Additionally, VegaLite.jl provides basic support for Vega.

VegaLite.jl allows you to create a wide range of statistical plots. It exposes the full functionality of the underlying Vega-Lite and is at the same time tightly integrated into the julia ecosystem. Here is an example of a scatter plot:

using VegaLite, VegaDatasets

dataset("cars") |>
@vlplot(
    :point,
    x=:Horsepower,
    y=:Miles_per_Gallon,
    color=:Origin,
    width=400,
    height=400
)

plot

Installation

To install VegaLite.jl, run the following command in the julia Pkg REPL-mode:

(v1.0) pkg> add VegaLite

Documentation

The current documentation can be found here.

Note for Jupyterlab Users

VegaLite.jl can be used in combination with many different front end clients including JupyterLab, Pluto.jl, and Julia for VSCode.

Important: JupyterLab supplies its own version of Vega-Lite and cannot be kept in perfect sync with VegaLite.jl. Formatting discrepancies can and will arise on occasion for JupyterLab users. VegaLite.jl targets the latest available minor release of Vega-Lite which is also supported by JupyterLab.

Developer Notes

JupyterLab support depends on Juperlab's built-in renderer; before updating to a new major version of vega-lite, check the JupyterLab project for the latest supported version of vega-lite.