.body {

font-family:"Open Sans", sans-serif;

}

.navbar-brandimg {

height:30px;

margin-top:4px;

}

.navbar .container {

padding-top:8px;

}

a {

color:#2391fe!important;

}

code {

color:#2391fe!important;

}

..currentmodule::{{ module }}

..autoclass::{{ objname }}

..autosummary::

:toctree: generated/

Figure

Figure.show

Figure.add_traces

Figure.update_traces

Figure.update_layout

..autoclass::{{ objname }}

{% block methods %}

..automethod::__init__

..automethod::show

..automethod::update_layout

..automethod::add_traces

{% endblock %}

Other methods

{{ underline }}==============

..autosummary::

:toctree: generated/

plotly.graph_objects.{{ objname }}

..autoclass::{{ objname }}

..raw::html

<divclass="clearer"></div>

:mod:`{{module}}`.{{objname}}

{{ underline }}

{{ underline }}============================

..currentmodule::{{ module }}

:mod:`{{module}}`.{{objname.lower()}}

{{ underline }}

{{ underline }}================================

..autosummary::

plotly API reference

Python API reference for `plotly`

This is the reference of plotly's API. Also see `plotly's documentation website<https://plot.ly/python>`_.

*:ref:`Plotlyexpress<px>`

*:ref:`Graphobjects: figures, traces and layout<graph-objects>`

*:ref:`Subplots<subplots>`

*:ref:`FigureFactory<ff>`

*:ref:`I/O<io>`

*:ref:`PlotlyExpress: high-level interface for data visualization<px>`

*:ref:`GraphObjects: low-level interface to figures, traces and layout<graph-objects>`

*:ref:`Subplots: helper function for layout out multi-plot figures<subplots>`

*:ref:`FigureFactories: helper methods for building specific complex charts<ff>`

*:ref:`I/O: low-level interface for displaying, reading and writing figures<io>`

Full reference list

..toctree::

.. _px:

Plotly express:`plotly.express`

`plotly.express`: high-level interface for data visualization

The `plotly.express<https://plot.ly/python/plotly-express/>`_ module is

.. _ff:

..currentmodule::plotly.figure_factory

create_streamline

create_table

create_ternary_contour

create_trisurf

create_trisurf

create_violin

.. _graph-objects:

Graph objects: figures, traces and layout

`plotly.graph_objects`: low-level interface to figures, traces and layout

..currentmodule::plotly.graph_objects

..toctree::

Figure

..autosummary::

:toctree: generated/

:template: class_figure.rst

Layout

.. _io:

..currentmodule::plotly.io

.. _subplots:

Subplots:`plotly.subplots`

`plotly.subplots`: helper function for laying out multi-plot figures

..currentmodule::plotly.subplots

name:python

nbconvert_exporter:python

pygments_lexer:ipython3

version:3.6.7

version:3.7.3

plotly:

description:How to format axes of 3d plots in Python with Plotly.

display_as:3d_charts

)

fig.show()

By default, guidelines originating from the tooltip point are drawn. It is possible to disable this behaviour with the`showspikes` parameter. In this example we only keep the`z` spikes (projection of the tooltip on the`x-y` plane). Hover on the data to show this behaviour.

import plotly.graph_objectsas go

import numpyas np

N=50

fig= go.Figure(data=[go.Mesh3d(x=(30*np.random.randn(N)),

y=(25*np.random.randn(N)),

z=(30*np.random.randn(N)),

opacity=0.5,)])

fig.update_layout(scene=dict(xaxis_showspikes=False,

yaxis_showspikes=False))

fig.show()

extension:.md

format_name:markdown

format_version:'1.1'

jupytext_version:1.1.6

jupytext_version:1.1.1

kernelspec:

display_name:Python 3

language:python

page_type:example_index

permalink:python/creating-and-updating-figures/

redirect_from:

-python/user-guide/

-python/user-g/

-python/user-guide/

-python/user-g/

thumbnail:thumbnail/creating-and-updating-figures.png

fig.show()

`update_layout` and`update_traces` have an`overwrite` keyword argument, defaulting to False, in which case updates are applied recursively to the*existing* nested property structure. When set to True, the prior value of existing properties is overwritten with the provided value.

In the example below, the red color of markers is overwritten when updating`marker` in`update_traces` with`overwrite=True`. Note that setting instead`marker_opacity` with the magic underscore would not overwrite`marker_color` because properties would be overwritten starting only at the level of`marker.opacity`.

import plotly.graph_objectsas go

fig= go.Figure(go.Bar(x=[1,2,3],y=[6,4,9],

marker_color="red"))# will be overwritten below

fig.update_traces(

overwrite=True,

marker={"opacity":0.4}

)

fig.show()

Suppose the updates that you want to make to a collection of traces depend on the current values of certain trace properties. The`update_traces` method cannot handle this situation, but the`for_each_trace` method can.