https://github.com/vega/vega

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

canvas d3 svg vega visualization visualization-grammar

Last synced: 7 days ago
JSON representation

A visualization grammar.

• Host: GitHub
• URL: https://github.com/vega/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-29T19:49:14.000Z (3 months ago)
• Last Synced: 2025-01-02T09:33:43.370Z (11 days ago)
• Topics: canvas, d3, svg, vega, visualization, visualization-grammar
• Language: JavaScript
• Homepage: https://vega.github.io/vega
• Size: 94.8 MB
• Stars: 11,298
• Watchers: 289
• Forks: 1,510
• Open Issues: 489
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-d3 - vega - A visualization grammar (Charts)
• Awesome - Vega - A visualization grammar. (Multimedia / Image and pictures)
• awesome-github-star - vega
• awesome-d3 - vega - A visualization grammar (Charts)
• awesome-vega - Vega repository
• awesome-list - Vega - A visualization grammar, a declarative format for creating, saving, and sharing interactive visualization designs. (Data Visualization / Data Management)
• awesome-d3 - vega - A visualization grammar (Charts)
• awesome-starred - vega/vega - A visualization grammar. (others)
• StarryDivineSky - vega/vega
• awesome - vega/vega - A visualization grammar. (JavaScript)
• awesome - vega/vega - A visualization grammar. (JavaScript)

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/orgs/vega/projects/9/views/3?pane=info).