Skip to content

QuantStack/xplot

Repository files navigation

xplot

Travis Appveyor Documentation Binder Join the Gitter Chat

C++ backend for the bqplot 2-D plotting library.

xplot is an early developer preview, and is not suitable for general usage yet. Features and implementation are subject to change.

Introduction

xplot is a C++ backend for the bqplot 2-D plotting library. It is based upon the xwidgets library, the C++ implementation of the Jupyter interactive widgets protocol.

xplot enables the use of the bqplot 2-D library in the C++ notebook, powered by the xeus-cling kernel and the cling C++ interpreter from CERN. xplot can also be used to create applications making use of the Jupyter interactive widgets without the C++ kernel.

Installation

We provide a package for the conda package manager.

  • Installing xplot and the C++ kernel
conda install xeus-cling xplot -c QuantStack -c conda-forge

Then, the front-end extension must be installed for either the classic notebook or JupyterLab.

  • Installing the extensions for the classic notebook
conda install widgetsnbextension -c conda-forge
conda install bqplot>=0.11.4,<0.12 -c conda-forge
  • Installing the JupyterLab extension
jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install bqplot@^0.4.3

Or you can directly install it from the sources if you have all the dependencies already installed:

cmake -D CMAKE_INSTALL_PREFIX=your_install_prefix
make install

Trying it online

To try out xtensor interactively in your web browser, just click on the binder link:

Binder

Documentation

To get started with using xplot, check out the full documentation

http://xplot.readthedocs.io/

Usage

xplot

Dependencies

All the dependencies of xplot are available for the conda package manager.

xplot xwidgets xeus
master ~0.20.0 >=0.23.3,<0.24
0.15.0 ~0.20.0 >=0.23.3,<0.24
0.14.0 ~0.19.0 >=0.21.1,<0.22
0.13.0 ~0.18.0 >=0.20.0,<0.21
0.12.0 ~0.17.0 >=0.19.1,<0.20
0.11.1 ~0.16.1 >=0.18.1,<0.19
0.11.0 ~0.16.0 >=0.18.1,<0.19
0.10.0 ~0.15.0 >=0.17.0,<0.18
0.9.2 ~0.13.1 >=0.14.1,<0.15
0.9.1 ~0.13.1 >=0.14.1,<0.15

Front-end dependency on the bqplot npm package

xplot bqplot npm package (bqplot python package)
master ^0.4.3 (^0.11.4)
0.15.0 ^0.4.3 (^0.11.4)

License

We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.

This software is licensed under the BSD-3-Clause license. See the LICENSE file for details.