An open-source, interactive data visualization library for Python
Project description
plotly.py
Latest Release | |
User forum | |
PyPI Downloads | |
License |
Quickstart
pip install plotly==4.10.0
Inside Jupyter notebook (installable with pip install "notebook>=5.3" "ipywidgets>=7.2"
):
import plotly.graph_objects as go
fig = go.Figure()
fig.add_trace(go.Scatter(y=[2, 1, 4, 3]))
fig.add_trace(go.Bar(y=[1, 4, 3, 2]))
fig.update_layout(title = 'Hello Figure')
fig.show()
See the Python documentation for more examples.
Read about what's new in plotly.py v4
Overview
plotly.py is an interactive, open-source, and browser-based graphing library for Python :sparkles:
Built on top of plotly.js, plotly.py
is a high-level, declarative charting library. plotly.js ships with over 30 chart types, including scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.
plotly.py
is MIT Licensed. Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online using Chart Studio Cloud.
Contact us for consulting, dashboard development, application integration, and feature additions.
- Online Documentation
- Contributing to plotly
- Changelog
- Code of Conduct
- Version 4 Migration Guide
- New! Announcing Dash 1.0
- Community forum
Installation
plotly.py may be installed using pip...
pip install plotly==4.10.0
or conda.
conda install -c plotly plotly=4.10.0
Jupyter Notebook Support
For use in the Jupyter Notebook, install the notebook
and ipywidgets
packages using pip...
pip install "notebook>=5.3" "ipywidgets==7.5"
or conda.
conda install "notebook>=5.3" "ipywidgets=7.5"
JupyterLab Support (Python 3.5+)
For use in JupyterLab, install the jupyterlab
and ipywidgets
packages using pip...
pip install jupyterlab "ipywidgets==7.5"
or conda.
conda install jupyterlab "ipywidgets=7.5"
Then run the following commands to install the required JupyterLab extensions (note that this will require node
to be installed):
# Basic JupyterLab renderer support
jupyter labextension install jupyterlab-plotly@4.10.0
# OPTIONAL: Jupyter widgets extension for FigureWidget support
jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.10.0
Please check out our Troubleshooting guide if you run into any problems with JupyterLab.
Static Image Export
plotly.py supports static image export,
using the either the kaleido
package (recommended, supported as of plotly
version 4.9) or the orca
command line utility (legacy as of plotly
version 4.9).
Kaleido
The kaleido
package has no dependencies and can be installed
using pip...
$ pip install -U kaleido
or conda.
$ conda install -c plotly python-kaleido
Orca
While Kaleido is now the recommended image export approach because it is easier to install
and more widely compatible, static image export
can also be supported
by the legacy orca command line utility and the
psutil
Python package.
These dependencies can both be installed using conda:
conda install -c plotly plotly-orca==1.3.1 psutil
Or, psutil
can be installed using pip...
pip install psutil
and orca can be installed according to the instructions in the orca README.
Extended Geo Support
Some plotly.py features rely on fairly large geographic shape files. The county
choropleth figure factory is one such example. These shape files are distributed as a
separate plotly-geo
package. This package can be installed using pip...
pip install plotly-geo==1.0.0
or conda
conda install -c plotly plotly-geo=1.0.0
Chart Studio support
The chart-studio
package can be used to upload plotly figures to Plotly's Chart
Studio Cloud or On-Prem service. This package can be installed using pip...
pip install chart-studio==1.0.0
or conda
conda install -c plotly chart-studio=1.0.0
Migration
If you're migrating from plotly.py v3 to v4, please check out the Version 4 migration guide
If you're migrating from plotly.py v2 to v3, please check out the Version 3 migration guide
Copyright and Licenses
Code and documentation copyright 2019 Plotly, Inc.
Code released under the MIT license.
Docs released under the Creative Commons license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for plotly-4.10.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 752f0803588b8d895d604c58fa55119ad104f3fbdd5eb5f7d11a3079680c31c0 |
|
MD5 | 65fb2a5ec642fbeb40763e3f5377045d |
|
BLAKE2b-256 | 0420c2d77eef33dbd40c5e3263a9a8763ffca610a4c3d2b2da21c5601e5fc5d8 |