plotly


Nameplotly JSON
Version 5.21.0 PyPI version JSON
download
home_pagehttps://plotly.com/python/
SummaryAn open-source, interactive data visualization library for Python
upload_time2024-04-17 15:19:41
maintainerNicolas Kruchten
docs_urlNone
authorChris P
requires_python>=3.8
licenseMIT
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"
}
        
Elapsed time: 0.19937s