Plotly

Warnings

• breaking Plotly.py 6.0 dropped support for Jupyter Notebook versions prior to 7.0. Users on older Jupyter versions will need to upgrade.
  Fix: Upgrade your Jupyter Notebook installation to version 7.0 or newer (e.g., `pip install --upgrade notebook`).
• breaking Plotly.py 6.0 introduced a rewrite of dataframe performance using the Narwhals abstraction layer instead of solely relying on the Pandas API. While generally providing performance gains, this might subtly affect direct Pandas dataframe interactions for users upgrading from older versions.
  Fix: Review code interacting directly with Pandas DataFrames if experiencing unexpected behavior or performance changes after upgrading. Consider adopting the dataframe interchange protocol for broader compatibility.
• breaking Plotly.js 3.0 (which plotly.py 6.0 is built upon) removed support for several deprecated attributes (e.g., `titlefont`, `titleposition`, `titleside`, `titleoffset`) and specific trace types like `pointcloud` and `heatmapgl`.
  Fix: Consult the Plotly.js 3.0 changelog for replacement attributes or alternative trace types if using any of the removed features.
• gotcha For static image export of Plotly figures (e.g., to PNG, JPEG, SVG, PDF), the `kaleido` package is the recommended engine since Plotly 4.9. The older `orca` command-line utility is now considered legacy and may have compatibility issues.
  Fix: Install `kaleido` (`pip install -U kaleido`) for reliable static image export. Remove any reliance on `orca`.
• gotcha When creating figures, `plotly.express` automatically infers sensible defaults and is much more concise (5-100 times less code) than building figures directly with `plotly.graph_objects`. Using `go` requires explicit definition of traces and layout.
  Fix: For most common plotting needs, start with `plotly.express`. Use `plotly.graph_objects` when `plotly.express` doesn't provide the necessary customization or for highly specialized plots (e.g., certain 3D trace types, complex subplots with different types).

Install

• pip install plotly Basic Installation
• pip install 'plotly[kaleido]' # For static image export pip install plotly-geo # For extended geographic features With Optional Dependencies

Imports

• plotly.express

  import plotly.express as px

  This is the high-level API and the recommended starting point for most common plots.
• plotly.graph_objects

  import plotly.graph_objects as go

  This is the low-level API for fine-grained control over figures, traces, and layout, often used for complex or highly customized charts.
• plotly.io

  import plotly.io as pio

  Used for input/output operations like displaying figures or writing them to various formats (e.g., HTML, JSON, images).

Quickstart

This quickstart demonstrates creating a basic bar chart using `plotly.express`, the high-level API. The `fig.show()` method renders the interactive plot, typically in a browser or Jupyter environment.

import plotly.express as px

# Create a simple bar chart
fig = px.bar(x=["A", "B", "C"], y=[1, 3, 2], title="My First Plotly Chart")

# Display the figure (opens in browser/notebook)
fig.show()