Plotly极坐标图添加注释箭头：可行性及替代方案问询

问题1：Plotly当前是否支持极坐标图添加注释？ #

是的，Plotly 5.x及以上版本已原生支持极坐标图添加注释，2019年社区帖子提及的限制已被修复，无需依赖底层笛卡尔坐标系即可实现绑定极坐标的注释箭头。

问题2：在极坐标图生成箭头的技巧 #

方法1：使用原生极坐标注释（推荐） #

直接将注释的坐标引用设置为极坐标系，指定xref="polar"、yref="polar"（对应极坐标的r值），箭头起始坐标的引用同样设置为axref="polar"、ayref="polar"，注释会直接绑定在极坐标图上，不会触发底层笛卡尔轴的显示。

示例代码：

import plotly.express as px
import plotly.graph_objects as go
import pandas as pd

df = pd.DataFrame()

fig = px.scatter_polar(
    df,
    theta=None,
    r=None,
    range_theta=[-180, 180],
    start_angle=0,
    direction="counterclockwise",
    template="plotly_white",
)

# 极坐标下的箭头参数：theta（角度）和r（半径）
theta_end = [90, 45, 0]
r_end = [3, 5, 4]
theta_start = [0, 90, 180]
r_start = [4, 4, 4]

list_of_all_arrows = []
for theta0, r0, theta1, r1 in zip(theta_end, r_end, theta_start, r_start):
    arrow = go.layout.Annotation(dict(
        x=theta0,  # 极坐标的theta角度值
        y=r0,      # 极坐标的r半径值
        xref="polar", yref="polar",
        text="",
        showarrow=True,
        axref="polar", ayref='polar',
        ax=theta1,
        ay=r1,
        arrowhead=3,
        arrowwidth=1.5,
        arrowcolor='rgb(255,51,0)',
    ))
    list_of_all_arrows.append(arrow)

fig.update_layout(annotations=list_of_all_arrows)
fig.show()

方法2：用极坐标线条+标记模拟箭头 #

如果需要更灵活的样式，可通过go.Scatterpolar绘制线条，再在终点添加箭头形状的标记：

import plotly.express as px
import plotly.graph_objects as go
import pandas as pd

df = pd.DataFrame()

fig = px.scatter_polar(
    df,
    theta=None,
    r=None,
    range_theta=[-180, 180],
    start_angle=0,
    direction="counterclockwise",
    template="plotly_white",
)

# 定义箭头的起点和终点（theta角度, r半径）
arrow_data = [
    {"theta_start": 0, "r_start":4, "theta_end":90, "r_end":3},
    {"theta_start":90, "r_start":4, "theta_end":45, "r_end":5},
    {"theta_start":180, "r_start":4, "theta_end":0, "r_end":4},
]

for data in arrow_data:
    # 绘制箭头线条
    fig.add_trace(go.Scatterpolar(
        theta=[data["theta_start"], data["theta_end"]],
        r=[data["r_start"], data["r_end"]],
        mode='lines',
        line=dict(color='rgb(255,51,0)', width=1.5),
        showlegend=False
    ))
    # 在终点添加箭头标记
    fig.add_trace(go.Scatterpolar(
        theta=[data["theta_end"]],
        r=[data["r_end"]],
        mode='markers',
        marker=dict(symbol='triangle-up', color='rgb(255,51,0)', size=8),
        showlegend=False
    ))

fig.show()

方法3：隐藏笛卡尔轴（兼容旧版本） #

若因版本限制必须使用笛卡尔注释，可通过隐藏笛卡尔的x、y轴避免显示底层坐标系：

# 在原代码基础上添加以下配置
fig.update_layout(
    xaxis=dict(visible=False),
    yaxis=dict(visible=False)
)

注：该方法无法保证注释与极坐标的精准对齐，仅作为临时兼容方案。

内容的提问来源于stack exchange，提问作者PiWi