add_trace对append_trace

Question

add_trace和append_trace在实际中有什么区别吗？后者是前者的遗产吗？

在Plotly.py GitHub中，有88个add_trace +21个Python实例和9个markdowbn +7个append_trace实例。后者主要来自doc和packages/python/plotly/plotly/figure_factory。

在实际的子图文档中，有4个append_trace实例，而其他52个实例都是add_trace。

下面是从中提取的一个示例：

from plotly.subplots import make_subplots
import plotly.graph_objects as go

fig = make_subplots(rows=3, cols=1)

fig.append_trace(go.Scatter(
    x=[3, 4, 5],
    y=[1000, 1100, 1200],
), row=1, col=1)

fig.append_trace(go.Scatter(
    x=[2, 3, 4],
    y=[100, 110, 120],
), row=2, col=1)

fig.append_trace(go.Scatter(
    x=[0, 1, 2],
    y=[10, 11, 12]
), row=3, col=1)


fig.update_layout(height=600, width=600, title_text="Stacked Subplots")
fig.show()

我尝试将此代码段中的append_trace实例替换为add_trace，但没有观察到任何明显的差异。

Answer 1

我没有技术背景来向您解释，但是官方的参考文献有以下解释

可以使用add_trace()方法将新的跟踪添加到图形对象图形中。此方法接受图形对象跟踪( go.Scatter、go.Bar等的实例)。并将其添加到数字中。这允许您从空图形开始，并按顺序向其添加跟踪。append_trace()方法执行相同的操作，尽管它不返回图。