Debian Codegraph @

bqplot/docs/source/introduction.rst

raw
1 .. _introduction:
2
3 Introduction
4 ============
5
6 bqplot is a Grammar of Graphics-based interactive plotting framework for the Jupyter notebook.
7
8 .. image:: ../../wealth-of-nations.gif
9
10 In bqplot, every single attribute of the plot is an interactive widget. This allows the user to integrate any plot with IPython widgets to create a complex and feature rich GUI from just a few simple lines of Python code.
11
12 Goals
13 -----
14
15 - provide a unified framework for 2-D visualizations with a pythonic API.
16 - provide a sensible API for adding user interactions (panning, zooming, selection, etc)
17
18 Two APIs are provided
19
20 - Users can build custom visualizations using the internal object model, which is inspired by the constructs of the Grammar of Graphics (figure, marks, axes, scales), and enrich their visualization with our Interaction Layer.
21 - Or they can use the context-based API similar to Matplotlib's pyplot, which provides sensible default choices for most parameters.
22
23 Installation
24 ------------
25
26 Using pip:
27
28 .. code:: bash
29
30 pip install bqplot
31 jupyter nbextension enable --py --sys-prefix bqplot # can be skipped for notebook version 5.3 and above
32
33 Using conda
34
35 .. code:: bash
36
37 conda install -c conda-forge bqplot