Skip to main content

Python plotting library for collaborative, interactive, publication-quality graphs.

Project description

The Nutshell

Use this package to make collaborative, interactive, publication-quality graphs from Python.

Here’s how you import:

import plotly.plotly as py              # for sending things to plotly
import plotly.tools as tls              # for mpl, config, etc.
from plotly.graph_objs import *         # __all__ is safely defined

Here’s how you sign in:

py.sign_in('PythonAPI', 'ubpiol2cve')   # get your own at https://plot.ly/

Here’s how you plot data or a figure:

py.plot(data_or_figure_here)

Here’s what you get:

  • an account on plotly

  • a unique url for your data/figures

  • an interactive web-application to edit your figure or make new figures

  • a platform on which to share your data/figures with the world

You can also convert supported matplotlib figures:

py.plot_mpl(mplfig)

Stop fighting with your figures; start designing them. Check out our Quickstart to get going.

About

Plotly is an online collaborative data analysis and graphing tool. The Python API allows you to access all of Plotly’s functionality from Python. Plotly figures are shared, tracked, and edited all online and the data is always accessible from the graph.

That’s it. Find out more, sign up, and start sharing by visiting us at https://plot.ly.

Install via pip

Assuming you have already installed pip, you can simply enter the following in a terminal program:

$ pip install plotly

Contributing!

If you want to contribute to making Plotly’s Python API experience better, head to our GitHub repo. Instructions for installing from here, updating the included submodules, and contributing are detailed there!

Plotly, matplotlib, and mpld3

The matplotlylib sub-package allows you to convert matplotlib figures to plotly figures, with a one-liner:

py.plot_mpl(fig)

Checkout the Plotly and mpld3 IPython notebook for more information.

Introduction to working with out API

Checkout the Plotly and Python IPython notebook to get a more in depth exposition of our Python API.

Plotly’s guide book

Still here? Don’t worry, we’ve got more documentation for you. Checkout a highly complete set of notebooks for walk-throughs on all the features we offer!

Details

The plotly package depends on requests, which will be installed by pip for you.

To use the matplotlylib subpackage, you’ll also need to have matplotlib 1.3.1 properly installed on your machine.

The matpotlylib package is based on the mplexporter framework for crawling and exporting matplotlib images.

Created by: Plotly, @plotlygraphs, feedback@plot.ly

License: MIT

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

plotly-3.6.0rc1.tar.gz (31.1 MB view hashes)

Uploaded Source

Built Distribution

plotly-3.6.0rc1-py2.py3-none-any.whl (38.6 MB view hashes)

Uploaded Python 2 Python 3

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