/holoviews

With Holoviews, your data visualizes itself.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

HoloViews logo HoloViews

Stop plotting your data - annotate your data and let it visualize itself.

Build Status Build Status
Coverage codecov
Latest dev release Github tag dev-site
Latest release Github release PyPI version holoviews version conda-forge version defaults version
Python Python support
Docs DocBuildStatus site
Binder Binder
Support Discourse

HoloViews is an open-source Python library designed to make data analysis and visualization seamless and simple. With HoloViews, you can usually express what you want to do in very few lines of code, letting you focus on what you are trying to explore and convey, not on the process of plotting.

Check out the HoloViews web site for extensive examples and documentation.

Installation

HoloViews works with Python 3 on Linux, Windows, or Mac, and works seamlessly with Jupyter Notebook and JupyterLab.

The recommended way to install HoloViews is using the conda command provided by Anaconda or Miniconda:

conda install -c pyviz holoviews bokeh

This command will install the typical packages most useful with HoloViews, though HoloViews itself depends only on Numpy Pandas and Param. Additional installation and configuration options are described in the user guide.

You can also clone holoviews directly from GitHub and install it with:

git clone git://github.com/holoviz/holoviews.git
cd holoviews
pip install -e .

Usage

Once you've installed HoloViews, you can get a copy of all the examples shown on this website:

holoviews --install-examples
cd holoviews-examples

Now you can launch Jupyter Notebook or JupyterLab to explore them:

jupyter notebook

jupyter lab

If you are working with a JupyterLab version <2.0 you will also need the PyViz JupyterLab extension:

jupyter labextension install @pyviz/jupyterlab_pyviz

For more details on setup and configuration see our website.

For general discussion, we have a gitter channel. If you find any bugs or have any feature suggestions please file a GitHub issue or submit a pull request.