Skip to content

Kitware/trame-vega

Repository files navigation

Vega visual grammar for trame

Test and Release

trame-vega extend trame widgets with a Figure component that is capable of rendering Vega grammars such as Altair plots.

Installing

trame-vega can be installed with pip:

pip install --upgrade trame-vega

Usage

The Trame Tutorial is the place to go to learn how to use the library and start building your own application.

The API Reference documentation provides API-level documentation.

License

trame-vega is made available under the BSD-3 License. For more details, see LICENSE This license has been chosen to match the one use by Vega and Altair which are either used within that trame widget or will be use by the user to create the content for those Figures.

Community

Trame | Discussions | Issues | RoadMap | Contact Us

Enjoying trame?

Share your experience with a testimonial or with a brand approval.

Example: Vega + Altair

The Python interface of Altair provide examples on how to create various visualization.

import altair as alt
from vega_datasets import data

from trame.widgets import vega

# Generate chart
source = data.cars()
fig = (
    alt.Chart(source)
    .mark_circle()
    .encode(
        alt.X(alt.repeat("column"), type="quantitative"),
        alt.Y(alt.repeat("row"), type="quantitative"),
        color="Origin:N",
    )
    .properties(width=200, height=200)
    .repeat(
        row=["Horsepower", "Acceleration", "Miles_per_Gallon"],
        column=["Miles_per_Gallon", "Acceleration", "Horsepower"],
    )
    .interactive()
)

# Display it
widget = vega.Figure(figure=None) # could pass fig at construction
widget.update(fig) # or update later