| Name | plotly JSON |
| Version |
5.21.0
JSON |
| download |
| home_page | https://plotly.com/python/ |
| Summary | An open-source, interactive data visualization library for Python |
| upload_time | 2024-04-17 15:19:41 |
| maintainer | Nicolas Kruchten |
| docs_url | None |
| author | Chris P |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# plotly.py
<table>
<tr>
<td>Latest Release</td>
<td>
<a href="https://pypi.org/project/plotly/"/>
<img src="https://badge.fury.io/py/plotly.svg"/>
</td>
</tr>
<tr>
<td>User forum</td>
<td>
<a href="https://community.plotly.com/"/>
<img src="https://img.shields.io/badge/help_forum-discourse-blue.svg"/>
</td>
</tr>
<tr>
<td>PyPI Downloads</td>
<td>
<a href="https://pepy.tech/project/plotly"/>
<img src="https://pepy.tech/badge/plotly/month"/>
</td>
</tr>
<tr>
<td>License</td>
<td>
<a href="https://opensource.org/licenses/MIT"/>
<img src="https://img.shields.io/badge/License-MIT-yellow.svg"/>
</td>
</tr>
</table>
## Quickstart
`pip install plotly==5.21.0`
Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
```python
import plotly.express as px
fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
fig.show()
```
See the [Python documentation](https://plotly.com/python/) for more examples.
## Overview
[plotly.py](https://plotly.com/python/) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
Built on top of [plotly.js](https://github.com/plotly/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](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or integrated into [Dash applications](https://dash.plotly.com/).
[Contact us](https://plotly.com/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
<p align="center">
<a href="https://plotly.com/python/" target="_blank">
<img src="https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/plotly_2017.png">
</a></p>
---
- [Online Documentation](https://plotly.com/python/)
- [Contributing to plotly](https://github.com/plotly/plotly.py/blob/master/contributing.md)
- [Changelog](https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md)
- [Code of Conduct](https://github.com/plotly/plotly.py/blob/master/CODE_OF_CONDUCT.md)
- [Version 4 Migration Guide](https://plotly.com/python/v4-migration/)
- [New! Announcing Dash 1.0](https://medium.com/plotly/welcoming-dash-1-0-0-f3af4b84bae)
- [Community forum](https://community.plotly.com)
---
## Installation
plotly.py may be installed using pip...
```
pip install plotly==5.21.0
```
or conda.
```
conda install -c plotly plotly=5.21.0
```
### JupyterLab Support
For use in [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/), 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`](https://nodejs.org/) to be installed):
```
# JupyterLab 2.x renderer support
jupyter labextension install jupyterlab-plotly@5.21.0 @jupyter-widgets/jupyterlab-manager
```
Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) 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](https://plotly.com/python/static-image-export/),
using either the [`kaleido`](https://github.com/plotly/Kaleido)
package (recommended, supported as of `plotly` version 4.9) or the [orca](https://github.com/plotly/orca)
command 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 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](https://plotly.com/python/static-image-export/)
can also be supported
by the legacy [orca](https://github.com/plotly/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](https://github.com/plotly/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
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
```
## Migration
If you're migrating from plotly.py v3 to v4, please check out the [Version 4 migration guide](https://plotly.com/python/v4-migration/)
If you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](https://github.com/plotly/plotly.py/blob/master/migration-guide.md)
## Copyright and Licenses
Code and documentation copyright 2019 Plotly, Inc.
Code released under the [MIT license](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt).
Docs released under the [Creative Commons license](https://github.com/plotly/documentation/blob/source/LICENSE).
Raw data
{
"_id": null,
"home_page": "https://plotly.com/python/",
"name": "plotly",
"maintainer": "Nicolas Kruchten",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "nicolas@plot.ly",
"keywords": null,
"author": "Chris P",
"author_email": "chris@plot.ly",
"download_url": "https://files.pythonhosted.org/packages/8d/0c/157c6e57fb0c29d66056f265316d6d2ccd5bad60dc427b01d3d626dfd356/plotly-5.21.0.tar.gz",
"platform": null,
"description": "# plotly.py\n\n<table>\n <tr>\n <td>Latest Release</td>\n <td>\n <a href=\"https://pypi.org/project/plotly/\"/>\n <img src=\"https://badge.fury.io/py/plotly.svg\"/>\n </td>\n </tr>\n <tr>\n <td>User forum</td>\n <td>\n <a href=\"https://community.plotly.com/\"/>\n <img src=\"https://img.shields.io/badge/help_forum-discourse-blue.svg\"/>\n </td>\n </tr>\n <tr>\n <td>PyPI Downloads</td>\n <td>\n <a href=\"https://pepy.tech/project/plotly\"/>\n <img src=\"https://pepy.tech/badge/plotly/month\"/>\n </td>\n </tr>\n <tr>\n <td>License</td>\n <td>\n <a href=\"https://opensource.org/licenses/MIT\"/>\n <img src=\"https://img.shields.io/badge/License-MIT-yellow.svg\"/>\n </td>\n </tr>\n</table>\n\n## Quickstart\n\n`pip install plotly==5.21.0`\n\nInside [Jupyter](https://jupyter.org/install) (installable with `pip install \"jupyterlab>=3\" \"ipywidgets>=7.6\"`):\n\n```python\nimport plotly.express as px\nfig = px.bar(x=[\"a\", \"b\", \"c\"], y=[1, 3, 2])\nfig.show()\n```\n\nSee the [Python documentation](https://plotly.com/python/) for more examples.\n\n\n## Overview\n\n[plotly.py](https://plotly.com/python/) is an interactive, open-source, and browser-based graphing library for Python :sparkles:\n\nBuilt on top of [plotly.js](https://github.com/plotly/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.\n\n`plotly.py` is [MIT Licensed](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or integrated into [Dash applications](https://dash.plotly.com/).\n\n[Contact us](https://plotly.com/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.\n\n<p align=\"center\">\n <a href=\"https://plotly.com/python/\" target=\"_blank\">\n <img src=\"https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/plotly_2017.png\">\n</a></p>\n\n---\n\n- [Online Documentation](https://plotly.com/python/)\n- [Contributing to plotly](https://github.com/plotly/plotly.py/blob/master/contributing.md)\n- [Changelog](https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md)\n- [Code of Conduct](https://github.com/plotly/plotly.py/blob/master/CODE_OF_CONDUCT.md)\n- [Version 4 Migration Guide](https://plotly.com/python/v4-migration/)\n- [New! Announcing Dash 1.0](https://medium.com/plotly/welcoming-dash-1-0-0-f3af4b84bae)\n- [Community forum](https://community.plotly.com)\n\n---\n\n## Installation\n\nplotly.py may be installed using pip...\n\n```\npip install plotly==5.21.0\n```\n\nor conda.\n\n```\nconda install -c plotly plotly=5.21.0\n```\n\n### JupyterLab Support\n\nFor use in [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/), install the `jupyterlab` and `ipywidgets`\npackages using `pip`:\n\n```\npip install \"jupyterlab>=3\" \"ipywidgets>=7.6\"\n```\n\nor `conda`:\n\n```\nconda install \"jupyterlab>=3\" \"ipywidgets>=7.6\"\n```\n\nThe 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`](https://nodejs.org/) to be installed):\n\n```\n# JupyterLab 2.x renderer support\njupyter labextension install jupyterlab-plotly@5.21.0 @jupyter-widgets/jupyterlab-manager\n```\n\nPlease check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.\n\n### Jupyter Notebook Support\n\nFor use in the Jupyter Notebook, install the `notebook` and `ipywidgets`\npackages using `pip`:\n\n```\npip install \"notebook>=5.3\" \"ipywidgets>=7.5\"\n```\n\nor `conda`:\n\n```\nconda install \"notebook>=5.3\" \"ipywidgets>=7.5\"\n```\n\n### Static Image Export\n\nplotly.py supports [static image export](https://plotly.com/python/static-image-export/),\nusing either the [`kaleido`](https://github.com/plotly/Kaleido)\npackage (recommended, supported as of `plotly` version 4.9) or the [orca](https://github.com/plotly/orca)\ncommand line utility (legacy as of `plotly` version 4.9).\n\n#### Kaleido\n\nThe [`kaleido`](https://github.com/plotly/Kaleido) package has no dependencies and can be installed\nusing pip...\n\n```\npip install -U kaleido\n```\n\nor conda.\n\n```\nconda install -c conda-forge python-kaleido\n```\n\n#### Orca\n\nWhile Kaleido is now the recommended image export approach because it is easier to install\nand more widely compatible, [static image export](https://plotly.com/python/static-image-export/)\ncan also be supported\nby the legacy [orca](https://github.com/plotly/orca) command line utility and the\n [`psutil`](https://github.com/giampaolo/psutil) Python package.\n\nThese dependencies can both be installed using conda:\n\n```\nconda install -c plotly plotly-orca==1.3.1 psutil\n```\n\nOr, `psutil` can be installed using pip...\n\n```\npip install psutil\n```\n\nand orca can be installed according to the instructions in the [orca README](https://github.com/plotly/orca).\n\n\n### Extended Geo Support\n\nSome plotly.py features rely on fairly large geographic shape files. The county\nchoropleth figure factory is one such example. These shape files are distributed as a\nseparate `plotly-geo` package. This package can be installed using pip...\n\n```\npip install plotly-geo==1.0.0\n```\n\nor conda\n\n```\nconda install -c plotly plotly-geo=1.0.0\n```\n\n## Migration\n\nIf you're migrating from plotly.py v3 to v4, please check out the [Version 4 migration guide](https://plotly.com/python/v4-migration/)\n\nIf you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](https://github.com/plotly/plotly.py/blob/master/migration-guide.md)\n\n## Copyright and Licenses\n\nCode and documentation copyright 2019 Plotly, Inc.\n\nCode released under the [MIT license](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt).\n\nDocs released under the [Creative Commons license](https://github.com/plotly/documentation/blob/source/LICENSE).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An open-source, interactive data visualization library for Python",
"version": "5.21.0",
"project_urls": {
"Changelog": "https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md",
"Documentation": "https://plotly.com/python/",
"Github": "https://github.com/plotly/plotly.py",
"Homepage": "https://plotly.com/python/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "04e504cf049c08975e016da446356a47566889be8b6cf88ed45045774f5bf112",
"md5": "71b1f1bc89e3999ebbece542d0bd5802",
"sha256": "a33f41fd5922e45b2b253f795b200d14452eb625790bb72d0a72cf1328a6abbf"
},
"downloads": -1,
"filename": "plotly-5.21.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "71b1f1bc89e3999ebbece542d0bd5802",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15710922,
"upload_time": "2024-04-17T15:19:34",
"upload_time_iso_8601": "2024-04-17T15:19:34.410879Z",
"url": "https://files.pythonhosted.org/packages/04/e5/04cf049c08975e016da446356a47566889be8b6cf88ed45045774f5bf112/plotly-5.21.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8d0c157c6e57fb0c29d66056f265316d6d2ccd5bad60dc427b01d3d626dfd356",
"md5": "ef54f95c3f5c050cc6930523a6b1c72d",
"sha256": "69243f8c165d4be26c0df1c6f0b7b258e2dfeefe032763404ad7e7fb7d7c2073"
},
"downloads": -1,
"filename": "plotly-5.21.0.tar.gz",
"has_sig": false,
"md5_digest": "ef54f95c3f5c050cc6930523a6b1c72d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7866061,
"upload_time": "2024-04-17T15:19:41",
"upload_time_iso_8601": "2024-04-17T15:19:41.687371Z",
"url": "https://files.pythonhosted.org/packages/8d/0c/157c6e57fb0c29d66056f265316d6d2ccd5bad60dc427b01d3d626dfd356/plotly-5.21.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-17 15:19:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "plotly",
"github_project": "plotly.py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"lcname": "plotly"
}
