Github url

plotly.py

by plotly

plotly /plotly.py

The interactive graphing library for Python (includes Plotly Express) :sparkles:

7.5K Stars 1.6K Forks Last release: 26 days ago (v4.9.0) MIT License 4.4K Commits 105 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

plotly.py

| Latest Release | | | User forum | | | PyPI Downloads | | | License | |

Quickstart

pip install plotly==4.9.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.



Installation

plotly.py may be installed using pip...

pip install plotly==4.9.0

or conda.

conda install -c plotly plotly=4.9.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

](https://nodejs.org/) to be installed):

# Basic JupyterLab renderer support jupyter labextension install [email protected] # OPTIONAL: Jupyter widgets extension for FigureWidget support jupyter labextension install @jupyter-widgets/jupyterlab-manager [email protected]

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

](https://github.com/plotly/Kaleido)package (recommended, supported as of

plotly

version 4.9) or the orcacommand line utility (legacy as of

plotly

version 4.9).

Kaleido

The [

kaleido

](https://github.com/plotly/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 exportcan also be supported by the legacy orca command line utility and the [

psutil

](https://github.com/giampaolo/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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.