pip install plotly "notebook>=5.3" "ipywidgets>=7.2"
Inside Jupyter notebook:
import plotly.graph_objs as go fig = go.FigureWidget() # Display an empty figure fig
# Add a scatter chart fig.add_scatter(y=[2, 1, 4, 3]) # Add a bar chart fig.add_bar(y=[1, 4, 3, 2]) # Add a title fig.layout.title = 'Hello FigureWidget'
See the Python documentation for more examples.
Read about what's new in plotly.py v3
plotly.py is an interactive, open-source, and browser-based graphing library for Python
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.
- Online Documentation
- Code of Conduct
- Version 3 Migration Guide
- New! Announcing Dash
plotly.py may be installed using pip...
pip install plotly==4.1.0
conda install -c plotly plotly==4.1.0
Jupyter Notebook Support
For use in the Jupyter Notebook, install the
packages using pip...
pip install "notebook>=5.3" "ipywidgets==7.5"
conda install "notebook>=5.3" "ipywidgets=7.5"
JupyterLab Support (Python 3.5+)
For use in JupyterLab, install the
packages using pip...
pip install jupyterlab==1.0 "ipywidgets==7.5"
conda install jupyterlab=1.0 "ipywidgets=7.5"
Then run the following commands to install the required JupyterLab extensions:
Static Image Export
plotly.py supports static image export using the
functions in the
plotly.io package. This functionality requires the
installation of the plotly orca command line utility and the
psutil Python package.
These dependencies can both be installed using conda:
conda install -c plotly plotly-orca psutil
psutil can be installed using pip...
pip install psutil
and orca can be installed according to the instructions in the orca README.
Wrong Executable found
If you get an error message stating that the
orca executable that was found is not valid, this may be because another executable with the same name was found on your system. Please specify the complete path to the Plotly-Orca binary that you downloaded (for instance in the Miniconda folder) with the following command:
plotly.io.orca.config.executable = '/home/your_name/miniconda3/bin/orca'
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
plotly-geo package. This package can be installed using pip...
pip install plotly-geo==1.0.0
conda install -c plotly plotly-geo=1.0.0
Chart Studio support
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
conda install -c plotly chart-studio=1.0.0
If you're migrating from plotly.py version 3, please check out the Version 4 migration guide
If you're migrating from plotly.py version 2, 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.