Data

Tools

Indexes

Applications

Experiments

Open Source Science

jupyter-vega

IPython/Jupyter notebook module for Vega and Vega-Lite

https://github.com/vega/ipyvega

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ✓
    Committers with academic emails
    1 of 15 committers (6.7%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.5%) to scientific vocabulary

Keywords from Contributors

interactive closember embedding notebook jupyterlab packaging ipython repl visualisation distribution
Last synced: 10 months ago · JSON representation

Repository

IPython/Jupyter notebook module for Vega and Vega-Lite

Basic Info
  • Host: GitHub
  • Owner: vega
  • License: bsd-3-clause
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage:
  • Size: 55.9 MB
Statistics
  • Stars: 382
  • Watchers: 27
  • Forks: 65
  • Open Issues: 21
  • Releases: 1
Created almost 11 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

IPython Vega

PyPI npm version Build Status

IPython/Jupyter notebook module for Vega 5, and Vega-Lite 4. Notebooks with embedded visualizations can be viewed on GitHub and nbviewer. If you use JupyterLab (not the notebook), you don't need to install this extension since JupyterLab comes with built-in support for Vega and Vega-Lite.

Available on pypi and Conda Forge as vega.

Install and run

Python Package Index

To install vega and its dependencies from the Python Package Index using pip, use the following commands:

sh pip install jupyter pandas vega pip install --upgrade notebook # need jupyter_client >= 4.2 for sys-prefix below jupyter nbextension install --sys-prefix --py vega jupyter nbextension enable --py --sys-prefix vega

Conda Forge

If you use Conda, you probably already have the latest versions of the notebook and pandas installed. To install vega extension run:

sh conda install vega

Usage

Once the package is installed, run sh jupyter notebook to launch the Jupyter notebook server, and use vega within the notebook. See the example notebooks for Vega-Lite and Vega.

To run the notebooks yourself, you need to get the file cars.json.

Developers

This project uses Poetry. If you prefer a local virtual environment, run poetry config virtualenvs.in-project true first. Install requirements: poetry install.

Then activate the virtual environment with poetry shell.

Symlink files instead of copying files:

sh jupyter nbextension install --py --symlink --sys-prefix vega jupyter nbextension enable --py --sys-prefix vega

Run kernel with jupyter notebook. Run the tests with pytest vega.

To rebuild the JavaScript continuously, run yarn watch.

How to make a release

  • Update the JavaScript dependencies by changing package.json (e.g. with ncu).
  • Run yarn.
  • Update the version number in pyproject.toml (with poetry version [VERSION]), package.json, _frontend.py, and __init__.py
  • Rebuild the JavaScript with yarn build.
  • Make sure that everything still works (launch notebook and widgets and try the examples).
  • Add a git tag.
  • git push --tags.
  • Run npm publish to update https://www.npmjs.com/package/jupyter-vega.
  • Then run poetry publish --build to update https://pypi.python.org/pypi/vega.

The Conda feedstock for this package is at https://github.com/conda-forge/vega-feedstock. It should update automatically but we may need to merge a pull request with the updates.

Visual Regression Tests

ipyvega uses the same technical solution as ipywidgets for visual regression testing (i.e. Galata).

Therefore, the instructions provided for ipywidgets visual regression tests apply here.

Currently:

  • ipyvega uses ui-tests/tests/notebooks/vega.ipynb notebook for testing
  • reference images are in the ui-tests/tests/vega.test.ts-snapshots/ directory.

Owner

  • Name: Vega
  • Login: vega
  • Kind: organization

Data Visualization Languages & Tools

GitHub Events

Total
  • Watch event: 11
  • Delete event: 18
  • Issue comment event: 9
  • Push event: 11
  • Pull request review event: 11
  • Pull request event: 40
  • Fork event: 1
  • Create event: 23
Last Year
  • Watch event: 11
  • Delete event: 18
  • Issue comment event: 9
  • Push event: 11
  • Pull request review event: 11
  • Pull request event: 40
  • Fork event: 1
  • Create event: 23

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 673
  • Total Committers: 15
  • Avg Commits per committer: 44.867
  • Development Distribution Score (DDS): 0.597
Past Year
  • Commits: 28
  • Committers: 2
  • Avg Commits per committer: 14.0
  • Development Distribution Score (DDS): 0.107
Top Committers
Name Email Commits
Dominik Moritz d****z@g****m 271
dependabot-preview[bot] 2****] 183
dependabot[bot] 4****] 158
Jake VanderPlas j****p@g****m 30
Brian E. Granger e****g@g****m 15
CMP c****m@g****m 5
Maarten Breddels m****s@g****m 2
xtianpoli x****b@g****m 2
Brett Cannon b****n 1
Carlos Scheidegger c****d@c****t 1
Carson Sievert c****1@g****m 1
Jean-Daniel Fekete J****e@i****r 1
Theodore Ni 3****i 1
Todd t****8@g****m 1
stonebig s****4@g****m 1
Committer Domains (Top 20 + Academic)
inria.fr: 1 cscheid.net: 1

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 16
  • Total pull requests: 223
  • Average time to close issues: 4 months
  • Average time to close pull requests: 28 days
  • Total issue authors: 9
  • Total pull request authors: 7
  • Average comments per issue: 3.19
  • Average comments per pull request: 0.72
  • Merged pull requests: 125
  • Bot issues: 1
  • Bot pull requests: 204
Past Year
  • Issues: 1
  • Pull requests: 47
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 18 days
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 1.0
  • Average comments per pull request: 0.21
  • Merged pull requests: 19
  • Bot issues: 1
  • Bot pull requests: 45
View more stats
Top Authors
Issue Authors
  • domoritz (8)
  • mangecoeur (1)
  • stonebig (1)
  • cpsievert (1)
  • peterquirk (1)
  • dove88 (1)
  • jdfekete (1)
  • ABeltramo (1)
  • dependabot[bot] (1)
Pull Request Authors
  • dependabot[bot] (264)
  • domoritz (15)
  • xtianpoli (2)
  • cpsievert (2)
  • jdfekete (1)
  • stonebig (1)
  • tjni (1)
Top Labels
Issue Labels
enhancement (7) bug (1) dependencies (1) javascript (1)
Pull Request Labels
dependencies (264) javascript (201) python (41) github_actions (22)

Packages

  • Total packages: 5
  • Total downloads:
    • pypi 19,153 last-month
    • npm 42 last-month
  • Total docker downloads: 1,610
  • Total dependent packages: 9
    (may contain duplicates)
  • Total dependent repositories: 422
    (may contain duplicates)
  • Total versions: 90
  • Total maintainers: 4
pypi.org: vega

A Jupyter widget for Vega 5 and Vega-Lite 4

  • Versions: 40
  • Dependent Packages: 3
  • Dependent Repositories: 344
  • Downloads: 18,954 Last month
  • Docker Downloads: 1,313
Rankings
Dependent repos count: 0.8%
Docker downloads count: 2.0%
Dependent packages count: 2.4%
Average: 2.8%
Downloads: 3.0%
Stargazers count: 3.4%
Forks count: 5.4%
Maintainers (3)
bgranger Jake.Vanderplas Dominik.Moritz
Last synced: 11 months ago
pypi.org: vega3

Deprecated: please use vega

  • Versions: 15
  • Dependent Packages: 1
  • Dependent Repositories: 39
  • Downloads: 199 Last month
  • Docker Downloads: 297
Rankings
Docker downloads count: 1.8%
Dependent repos count: 2.3%
Stargazers count: 3.4%
Forks count: 5.4%
Average: 5.9%
Dependent packages count: 10.1%
Downloads: 12.2%
Maintainers (3)
bgranger Jake.Vanderplas Dominik.Moritz
Last synced: 11 months ago
npmjs.org: jupyter-vega

IPython/Jupyter notebook module for [Vega](https://vega.github.io/vega), and [Vega-Lite](https://vega.github.io/vega-lite).

  • Versions: 6
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 42 Last month
Rankings
Stargazers count: 4.1%
Forks count: 4.4%
Downloads: 8.4%
Average: 11.7%
Dependent packages count: 16.2%
Dependent repos count: 25.3%
Maintainers (1)
domoritz
Last synced: 11 months ago
conda-forge.org: vega
  • Versions: 26
  • Dependent Packages: 3
  • Dependent Repositories: 39
Rankings
Dependent repos count: 5.8%
Dependent packages count: 15.6%
Average: 16.4%
Stargazers count: 21.1%
Forks count: 23.0%
Last synced: 11 months ago
conda-forge.org: vega3
  • Versions: 3
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Stargazers count: 19.2%
Forks count: 21.4%
Average: 25.9%
Dependent packages count: 28.8%
Dependent repos count: 34.0%
Last synced: 11 months ago

Dependencies

package.json npm
  • filemanager-webpack-plugin ^7.0.0 development
  • prettier ^2.5.1 development
  • ts-loader ^9.2.6 development
  • typescript ^4.5.5 development
  • webpack ^5.68.0 development
  • webpack-cli ^4.9.2 development
  • @jupyter-widgets/base 4.1.1
  • @types/webpack-env *
  • vega 5.22.1
  • vega-embed ^6.20.6
  • vega-lite 4.17.0
yarn.lock npm
  • 342 dependencies
poetry.lock pypi
  • altair 4.1.0 develop
  • atomicwrites 1.4.0 develop
  • iniconfig 1.1.1 develop
  • pluggy 1.0.0 develop
  • pytest 7.0.1 develop
  • tomli 1.2.3 develop
  • toolz 0.11.2 develop
  • appnope 0.1.2
  • argon2-cffi 21.3.0
  • argon2-cffi-bindings 21.2.0
  • async-generator 1.10
  • attrs 21.4.0
  • backcall 0.2.0
  • bleach 4.1.0
  • cffi 1.15.0
  • colorama 0.4.4
  • dataclasses 0.8
  • decorator 5.1.1
  • defusedxml 0.7.1
  • entrypoints 0.4
  • importlib-metadata 4.8.3
  • ipykernel 5.5.6
  • ipython 7.16.3
  • ipython-genutils 0.2.0
  • ipywidgets 7.6.5
  • jedi 0.17.2
  • jinja2 3.0.3
  • jsonschema 4.0.0
  • jupyter 1.0.0
  • jupyter-client 7.1.2
  • jupyter-console 6.4.0
  • jupyter-core 4.9.1
  • jupyterlab-pygments 0.1.2
  • jupyterlab-widgets 1.0.2
  • markupsafe 2.0.1
  • mistune 0.8.4
  • nbclient 0.5.9
  • nbconvert 6.0.7
  • nbformat 5.1.3
  • nest-asyncio 1.5.4
  • notebook 6.4.8
  • numpy 1.19.5
  • packaging 21.3
  • pandas 1.1.5
  • pandocfilters 1.5.0
  • parso 0.7.1
  • pexpect 4.8.0
  • pickleshare 0.7.5
  • prometheus-client 0.13.1
  • prompt-toolkit 3.0.19
  • ptyprocess 0.7.0
  • py 1.11.0
  • pycparser 2.21
  • pygments 2.11.2
  • pyparsing 3.0.7
  • pyrsistent 0.18.0
  • python-dateutil 2.8.2
  • pytz 2021.3
  • pywin32 303
  • pywinpty 2.0.2
  • pyzmq 22.3.0
  • qtconsole 5.2.2
  • qtpy 2.0.1
  • send2trash 1.8.0
  • six 1.16.0
  • terminado 0.13.0
  • testpath 0.5.0
  • tornado 6.1
  • traitlets 4.3.3
  • typing-extensions 4.0.1
  • wcwidth 0.2.5
  • webencodings 0.5.1
  • widgetsnbextension 3.5.2
  • zipp 3.6.0
pyproject.toml pypi
  • altair ^4.0.1 develop
  • pytest ^7.0 develop
  • jupyter ^1.0.0
  • pandas ^1.0.0
  • python >= 3.6.1
.github/workflows/merge-dependabot.yml actions
  • akheron/dependabot-cron-action v1 composite
.github/workflows/test.yml actions
  • abatilo/actions-poetry v2.2.0 composite
  • actions/checkout v3 composite
  • actions/setup-node v3 composite
  • actions/setup-python v4 composite
.github/workflows/ui.yml actions
  • abatilo/actions-poetry v2.1.4 composite
  • actions/checkout v3 composite
  • actions/setup-node v3 composite
  • actions/setup-python v2.3.1 composite
  • actions/upload-artifact v2 composite
ui-tests/package.json npm
  • @jupyterlab/galata 3.0.11-2
  • @types/jest ^27.0.1
  • jest ^25.5.4