Vega-Lite is an implementation of the grammar-of-graphics, rendered in the browser with interactivity.
Accordingly, this package may be useful to:
vegawidget now supports the last two Vega-Lite major-versions, currently versions 5 and 4.
However, for a given R session (e.g. rendering of an RMarkdown file), the
vegawidget() function can use only one major-version; this version is determined using the
$schema element of the first
vegaspec evaluated using
vega_version_all() to see the available versions:
library("vegawidget") vega_version_all() #> widget vega_lite vega vega_embed #> 1 vl5 5.2.0 5.21.0 6.20.2 #> 2 vl4 4.17.0 5.17.0 6.12.2
You can install vegawidget from CRAN with:
The development version of vegawidget is available from GitHub with:
# install.packages("devtools") devtools::install_github("vegawidget/vegawidget")
Vega(-Lite) specifications are just text, formatted as JSON. However, in R, we can use lists to build specifications:
library("vegawidget") spec_mtcars <- list( `$schema` = vega_schema(), # specifies Vega-Lite description = "An mtcars example.", data = list(values = mtcars), mark = "point", encoding = list( x = list(field = "wt", type = "quantitative"), y = list(field = "mpg", type = "quantitative"), color = list(field = "cyl", type = "nominal") ) ) %>% as_vegaspec()
as_vegaspec() function is used to turn the list into a vegaspec; many of this package’s functions are built to support, and render, vegaspecs:
The rendering of the chart above depends on where you are reading it:
On this package’s pkgdown site, it is rendered as part of an HTML environment, showing its full capabilities.
At its GitHub code site, the chart is further rendered to a static SVG file, then incorporated into the Markdown rendering.
A learnr tutorial is available:
learnr::run_tutorial("overview", package = "vegawidget").
Other articles for this package: