https://vega.github.io/vega/

A visualization grammar.
https://vega.github.io/vega/

canvas d3 svg vega visualization visualization-grammar

Last synced: 3 months ago
JSON representation

A visualization grammar.

• Host: GitHub
• URL: https://vega.github.io/vega/
• Owner: vega
• License: bsd-3-clause
• Created: 2013-02-03T18:36:30.000Z (almost 12 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T01:22:38.000Z (3 months ago)
• Last Synced: 2024-10-18T07:41:21.799Z (3 months ago)
• Topics: canvas, d3, svg, vega, visualization, visualization-grammar
• Language: JavaScript
• Homepage: https://vega.github.io/vega
• Size: 94.8 MB
• Stars: 11,198
• Watchers: 289
• Forks: 1,501
• Open Issues: 478
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-canvas - vega - A visualization grammar.   (Libraries / Charts Libraries)
• awesome-viz - Vega - A visualization grammar, a declarative language for creating, saving, and sharing interactive visualization designs. With Vega, you can describe the visual appearance and interactive behavior of a visualization in a JSON format, and generate web-based views using Canvas or SVG. ([↑](#contents) Declarative)
• data-science-with-ruby - Vega - lite](https://vega.github.io/vega-lite/) (Visualization)

README

        
# Vega: A Visualization Grammar 







**Vega** is a *visualization grammar*, a declarative format for creating, saving, and sharing interactive visualization designs. With Vega you can describe data visualizations in a JSON format, and generate interactive views using either HTML5 Canvas or SVG.

For documentation, tutorials, and examples, see the [Vega website](https://vega.github.io/vega). For a description of changes between Vega 2 and later versions, please refer to the [Vega Porting Guide](https://vega.github.io/vega/docs/porting-guide/).

## Build Instructions

For a basic setup allowing you to build Vega and run examples:

- Clone `https://github.com/vega/vega`.

- Run `yarn` to install dependencies for all packages. If you don't have yarn installed, see https://yarnpkg.com/en/docs/install. We use [Yarn workspaces](https://yarnpkg.com/lang/en/docs/workspaces/) to manage multiple packages within this [monorepo](https://en.wikipedia.org/wiki/Monorepo).

- Once installation is complete, run `yarn test` to run test cases, or run `yarn build` to build output files for all packages.

- After running either `yarn test` or `yarn build`, run `yarn serve` to launch a local web server — your default browser will open and you can browse to the `"test"` folder to view test specifications.

This repository includes the Vega website and documentation in the `docs` folder. To launch the website locally, first run `bundle install` in the `docs` folder to install the necessary Jekyll libraries. Afterwards, use `yarn docs` to build the documentation and launch a local webserver. After launching, you can open [`http://127.0.0.1:4000/vega/`](http://127.0.0.1:4000/vega/) to see the website.

## Internet Explorer Support

For backwards compatibility, Vega includes a [babel-ified](https://babeljs.io/) IE-compatible version of the code in the `packages/vega/build-es5` directory. Older browser would also require several polyfill libraries:

```html

```

## Contributions, Development, and Support

Interested in contributing to Vega? Please see our [contribution and development guidelines](CONTRIBUTING.md), subject to our [code of conduct](https://github.com/vega/.github/blob/master/CODE_OF_CONDUCT.md).

Looking for support, or interested in sharing examples and tips? Post to the [Vega discussion forum](https://groups.google.com/forum/#!forum/vega-js) or join the [Vega slack organization](https://bit.ly/join-vega-slack-2020)! We also have examples available as [Observable notebooks](https://observablehq.com/@vega).

If you're curious about system performance, see some [in-browser benchmarks](https://observablehq.com/@vega/vega-performance-tests). Read about future plans in [our roadmap](https://github.com/vega/roadmap/projects/1).