pip install plotly
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.
plotly.py is MIT Licensed. Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online on plot.ly.
Contact us for Plotly.js consulting, dashboard development, application integration, and feature additions. Sharing your graphs online or in dashboards? Consider a plot.ly subscription.
- Online Documentation
- Contributing
- Changelog
- Code of Conduct
- Version 3 Migration Guide
- New! Announcing Dash
- Community
To install plotly.py and enable Jupyter or Jupyter Lab support, run:
pip install plotly==3.1.1
pip install "notebook>=5.3" "ipywidgets>=7.2" # only necessary for Jupyter Notebook environments
If you're using older versions of notebook or ipywidgets you may need to manually activate the widget extensions (this should not be needed for notebook>=5.3 and ipywidgets>=7.2)
jupyter nbextension enable --py widgetsnbextension --sys-prefix
jupyter nbextension enable --py plotlywidget --sys-prefix
In addition, to add JupyterLab support run the following commands
pip install jupyterlab==0.33
# Avoid "JavaScript heap out of memory" errors during extension installation
# (OS X/Linux)
export NODE_OPTIONS=--max-old-space-size=4096
# (Windows)
set NODE_OPTIONS=--max-old-space-size=4096
# Jupyter widgets extension
jupyter labextension install @jupyter-widgets/[email protected] --no-build
# FigureWidget support
jupyter labextension install [email protected] --no-build
# offline iplot support
jupyter labextension install @jupyterlab/[email protected] --no-build
# Build extensions (must be done to activate extensions since --no-build is used above)
jupyter lab build
If you're migrating from plotly.py version 2, please check out the migration guide
Code and documentation copyright 2018 Plotly, Inc.
Code released under the MIT license.
Docs released under the Creative Commons license.