plotly.py

<table> <tr> <td>最新版本</td> <td> <a href="https://pypi.org/project/plotly/"/> <img src="https://yellow-cdn.veclightyear.com/835a84d5/4e710334-2d62-4403-8ad0-f2ec91330161.svg"/> </td> </tr> <tr> <td>用户论坛</td> <td> <a href="https://community.plotly.com/"/> <img src="https://yellow-cdn.veclightyear.com/835a84d5/28ac655b-6b80-4ad5-bd92-f4408a6365da.svg"/> </td> </tr> <tr> <td>PyPI 下载量</td> <td> <a href="https://pepy.tech/project/plotly"/> <img src="https://pepy.tech/badge/plotly/month"/> </td> </tr> <tr> <td>许可证</td> <td> <a href="https://opensource.org/licenses/MIT"/> <img src="https://yellow-cdn.veclightyear.com/835a84d5/d6f36ce5-c9aa-4556-86de-8d22ba161808.svg"/> </td> </tr> </table> <div align="center"> <a href="https://dash.plotly.com/project-maintenance"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/41f5cc82-55da-4ab6-9f98-229ed22e4859.png" width="400px" alt="由Plotly维护"> </a> </div>

快速入门

pip install plotly==5.23.0

在Jupyter中（可通过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()

更多示例请参见Python文档。

概述

plotly.py是一个交互式、开源的、基于浏览器的Python图表库 :sparkles:

构建在plotly.js之上，plotly.py是一个高级的声明式图表库。plotly.js提供了30多种图表类型，包括科学图表、3D图形、统计图表、SVG地图、金融图表等。

plotly.py采用MIT许可证。Plotly图表可以在Jupyter笔记本、独立的HTML文件中查看，或集成到Dash应用程序中。

联系我们获取咨询、仪表板开发、应用程序集成和功能添加服务。

<p align="center"> <a href="https://plotly.com/python/" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/27c5aecb-9aca-4eac-85ef-ccc66e59a297.png"> </a></p>

---

• 在线文档
• 为plotly贡献
• 更新日志
• 行为准则
• 版本4迁移指南
• 新！宣布Dash 1.0
• 社区论坛

---

安装

plotly.py可以使用pip安装...

pip install plotly==5.23.0

或conda安装。

conda install -c plotly plotly=5.23.0

JupyterLab支持

要在JupyterLab中使用，请使用pip安装jupyterlab和ipywidgets包：

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

或使用conda：

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

以上说明适用于JupyterLab 3.x。对于JupyterLab 2或更早版本，运行以下命令安装所需的JupyterLab扩展（请注意，这需要安装node）：

# JupyterLab 2.x渲染器支持
jupyter labextension install jupyterlab-plotly@5.23.0 @jupyter-widgets/jupyterlab-manager

如果在JupyterLab中遇到任何问题，请查看我们的故障排除指南。

Jupyter Notebook支持

要在Jupyter Notebook中使用，请使用pip安装notebook和ipywidgets包：

pip install "notebook>=5.3" "ipywidgets>=7.5"

或使用conda：

conda install "notebook>=5.3" "ipywidgets>=7.5"

静态图像导出

plotly.py支持静态图像导出， 可以使用kaleido包（推荐，从plotly版本4.9开始支持）或orca命令行工具（从plotly版本4.9开始已过时）。

Kaleido

kaleido包没有依赖项，可以使用pip安装...

pip install -U kaleido

或conda安装。

conda install -c conda-forge python-kaleido

Orca

虽然Kaleido现在是推荐的图像导出方法，因为它更易于安装且兼容性更广，但静态图像导出也可以通过旧版orca命令行工具和psutil Python包支持。

这些依赖项都可以使用conda安装：

conda install -c plotly plotly-orca==1.3.1 psutil

或者，可以使用pip安装psutil...

pip install psutil

orca可以按照orca README中的说明安装。

扩展地理支持

一些plotly.py功能依赖于相当大的地理形状文件。县级地图集图工厂就是一个这样的例子。这些形状文件作为单独的plotly-geo包分发。可以使用pip安装此包...

pip install plotly-geo==1.0.0

或conda

conda install -c plotly plotly-geo=1.0.0

迁移

如果您正在从plotly.py v3迁移到v4，请查看版本4迁移指南

如果您正在从plotly.py v2迁移到v3，请查看版本3迁移指南

版权和许可

代码和文档版权归2019 Plotly, Inc.所有。

代码根据MIT许可证发布。

文档根据Creative Commons许可证发布。