plotly.graph_objects.Figure

Figure([data, layout, frames, skip_invalid])
Figure.show(*args, **kwargs)	Show a figure using either the default renderer(s) or the renderer(s) specified by the renderer argument
Figure.add_traces(data[, rows, cols, …])	Add traces to the figure
Figure.update_traces([patch, selector, row, …])	Perform a property update operation on all traces that satisfy the specified selection criteria
Figure.update_layout([dict1, overwrite])	Update the properties of the figure’s layout with a dict and/or with keyword arguments.

class plotly.graph_objects.Figure(data=None, layout=None, frames=None, skip_invalid=False, **kwargs)

__init__(data=None, layout=None, frames=None, skip_invalid=False, **kwargs)

Create a new :class:Figure instance

Parameters

• data –

  The ‘data’ property is a tuple of trace instances that may be specified as:

  • A list or tuple of trace instances (e.g. [Scatter(…), Bar(…)])

  • A single trace instance (e.g. Scatter(…), Bar(…), etc.)

  • A list or tuple of dicts of string/value properties where: - The ‘type’ property specifies the trace type

    One of: [‘bar’, ‘barpolar’, ‘box’, ‘candlestick’,

    ’carpet’, ‘choropleth’, ‘choroplethmap’, ‘cone’, ‘contour’, ‘contourcarpet’, ‘densitymap’, ‘funnel’, ‘funnelarea’, ‘heatmap’, ‘histogram’, ‘histogram2d’, ‘histogram2dcontour’, ‘icicle’, ‘image’, ‘indicator’, ‘isosurface’, ‘mesh3d’, ‘ohlc’, ‘parcats’, ‘parcoords’, ‘pie’, ‘quiver’, ‘sankey’, ‘scatter’, ‘scatter3d’, ‘scattercarpet’, ‘scattergeo’, ‘scattergl’, ‘scattermap’, ‘scatterpolar’, ‘scatterpolargl’, ‘scattersmith’, ‘scatterternary’, ‘splom’, ‘streamtube’, ‘sunburst’, ‘surface’, ‘table’, ‘treemap’, ‘violin’, ‘volume’, ‘waterfall’]

    • All remaining properties are passed to the constructor of the specified trace type

    (e.g. [{‘type’: ‘scatter’, …}, {‘type’: ‘bar, …}])

• layout –

  The ‘layout’ property is an instance of Layout that may be specified as:

  • An instance of plotly.graph_objects.Layout

  • A dict of string/value properties that will be passed to the Layout constructor

• frames –

  The ‘frames’ property is a tuple of instances of Frame that may be specified as:

  • A list or tuple of instances of plotly.graph_objects.Frame

  • A list or tuple of dicts of string/value properties that will be passed to the Frame constructor

• skip_invalid (bool) – If True, invalid properties in the figure specification will be skipped silently. If False (default) invalid properties in the figure specification will result in a ValueError

Raises

ValueError – if a property in the specification of data, layout, or frames is invalid AND skip_invalid is False

class plotly.graph_objects.Figure(data=None, layout=None, frames=None, skip_invalid=False, **kwargs)

add_annotation(arg=None, align=None, arrowcolor=None, arrowhead=None, arrowside=None, arrowsize=None, arrowwidth=None, ax=None, axref=None, ay=None, ayref=None, bgcolor=None,