You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/python/figure-introspection.md
+11-11
Original file line number
Diff line number
Diff line change
@@ -27,15 +27,15 @@ jupyter:
27
27
language: python
28
28
layout: base
29
29
name: Introspecting Figures
30
-
order: 35
30
+
order: 36
31
31
page_type: u-guide
32
32
permalink: python/figure-introspection/
33
33
thumbnail: thumbnail/violin.jpg
34
34
---
35
35
36
36
### The Figure Lifecycle
37
37
38
-
As explained in the [Figure Data Structure documentation](/python/figure-structure/), when building a figure object with Plotly.py, it is not necessary to populate every possible attribute. At render-time, figure objects (whether generated via [Plotly Express](/python/plotly-express/) or [Graph Objects](/python/graph-objects/) are passed from Plotly.py to [Plotly.js](/javascript/), which is the Javascript library responsible for turning JSON descriptions of figures into graphical representations.
38
+
As explained in the [Figure Data Structure documentation](/python/figure-structure/), when building a figure object with Plotly.py, it is not necessary to populate every possible attribute. At render-time, figure objects (whether generated via [Plotly Express](/python/plotly-express/) or [Graph Objects](/python/graph-objects/) are passed from Plotly.py to [Plotly.js](/javascript/), which is the Javascript library responsible for turning JSON descriptions of figures into graphical representations.
39
39
40
40
As part of this rendering process, Plotly.js will determine, based on the attributes that have been set, which other attributes require values in order to draw the figure. Plotly.js will then apply either static or dynamic defaults to all of the remaining required attributes and render the figure. A good example of a static default would be the text font size: if unspecified, the default value is always the same. A good example of a dynamic default would be the range of an axis: if unspecified, the default will be computed based on the range of the data in traces associated with that axis.
41
41
@@ -71,9 +71,9 @@ import plotly.graph_objects as go
Now let's look at the "full" figure after Plotly.js has computed the default values for every necessary attribute.
91
91
92
-
> Heads-up: the full figure is quite long and intimidating, and this page is meant to help demystify things so **please read on**!
92
+
> Heads-up: the full figure is quite long and intimidating, and this page is meant to help demystify things so **please read on**!
93
93
94
94
Please also note that the `.full_figure_for_development()` function is really meant for interactive learning and debugging, rather than production use, hence its name and the warning it produces by default, which you can see below, and which can be supressed with `warn=False`.
0 commit comments