Skip to main content

An open-source, interactive data visualization library for Python

Project description

plotly.py

Latest Release
User forum
PyPI Downloads
License

Quickstart

pip install plotly==5.7.0

Inside Jupyter (installable with pip install "jupyterlab>=3" "ipywidgets>=7.6"):

import plotly.express as px
fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
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==5.7.0

or conda.

conda install -c plotly plotly=5.7.0

JupyterLab Support

For use in JupyterLab, install the jupyterlab and ipywidgets packages using pip:

pip install "jupyterlab>=3" "ipywidgets>=7.6"

or conda:

conda install "jupyterlab>=3" "ipywidgets>=7.6"

The instructions above apply to JupyterLab 3.x. For JupyterLab 2 or earlier, run the following commands to install the required JupyterLab extensions (note that this will require node to be installed):

# JupyterLab 2.x renderer support
jupyter labextension install jupyterlab-plotly@5.7.0 @jupyter-widgets/jupyterlab-manager

Please check out our Troubleshooting guide if you run into any problems with JupyterLab.

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"

Static Image Export

plotly.py supports static image export, using 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 conda-forge 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.1.0

or conda

conda install -c plotly chart-studio=1.1.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

This version

5.7.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plotly-5.7.0.tar.gz (8.6 MB view details)

Uploaded Source

Built Distribution

plotly-5.7.0-py2.py3-none-any.whl (28.8 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file plotly-5.7.0.tar.gz.

File metadata

  • Download URL: plotly-5.7.0.tar.gz
  • Upload date:
  • Size: 8.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.7

File hashes

Hashes for plotly-5.7.0.tar.gz
Algorithm Hash digest
SHA256 15ab20e9ed8b55f669b3d35e186eb48f9e1fe07321a1337b8b7df8d3573d265a
MD5 455cf568528c4aab7408051677d1f16b
BLAKE2b-256 aa9269d702f337dd179525562631c2e2113504a4ea5b4183f993f372a9b72e3c

See more details on using hashes here.

Provenance

File details

Details for the file plotly-5.7.0-py2.py3-none-any.whl.

File metadata

  • Download URL: plotly-5.7.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 28.8 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.7

File hashes

Hashes for plotly-5.7.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3a35131762c6567813012462e1d496e1d3898f56ab3d386b32f103f7f0c79cf1
MD5 f65e4d67891f4a25c9c45e5530e43615
BLAKE2b-256 cb7053e9f634e6d3aedbe2e99deca846226385d5d845212171e227e2502fb240

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page