用途:Plotly 是用于创建交互式、出版级可视化的 Python 绘图库,支持 40 多种图表类型。需要悬停提示、缩放、平移或网页嵌入图表时使用,适合仪表盘、探索性分析笔记本与演示。
安装与基本用法:使用 uv pip install plotly 安装。高层 API 示例:import plotly.express as px;df 为 pandas DataFrame,fig = px.scatter(df, x='x', y='y', title='My First Plot');fig.show()。
两套 API 选择:Plotly Express(px)适合快速标准可视化、pandas DataFrame、常见图表类型、自动配色与图例,代码量少;Graph Objects(go)适合精细控制、特殊图表类型(3D 网格、等值面、复杂金融图)、多轨迹图形与自定义形状标注。px 返回 Figure,可混用 go 方法,如 fig.update_layout、fig.add_hline。
主要能力:图表类型涵盖基础、统计、科学、金融、地图、3D 与专用图(旭日、矩形树、桑基、平行坐标、仪表盘等);布局支持子图、模板与外观定制;交互支持悬停模板、缩放平移、图例切换、框选套索、范围滑块、按钮下拉与动画。
导出:write_html 输出交互式 HTML,可用 include_plotlyjs='cdn' 减小体积;静态图片需安装 kaleido(uv pip install kaleido),可写 PNG、PDF、SVG。
集成:可用 Dash 构建交互式 Web 应用,安装 uv pip install dash,用 dcc.Graph(figure=fig) 嵌入图表,app.run_server(debug=True) 运行。
限制:仅当任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。更完整的 API 与图表示例见官方文档 https://plotly.com/python/ 与 API 参考 https://plotly.com/python-api-reference/。