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
{{ message }}
Repository navigation
Commit 38374ac
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: doc/python/3d-mesh.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ jupyter:
33
33
thumbnail: thumbnail/3d-mesh.jpg
34
34
---
35
35
36
-
### Simple 3D Mesh example ###
36
+
### Simple 3D Mesh Example
37
37
38
38
`go.Mesh3d` draws a 3D set of triangles with vertices given by `x`, `y` and `z`. If only coordinates are given, an algorithm such as [Delaunay triangulation](https://en.wikipedia.org/wiki/Delaunay_triangulation) is used to draw the triangles. Otherwise the triangles can be given using the `i`, `j` and `k` parameters (see examples below).
The `alphahull` parameter sets the shape of the mesh. If the value is -1 (default value) then [Delaunay triangulation](https://en.wikipedia.org/wiki/Delaunay_triangulation) is used. If >0 then the [alpha-shape algorithm](https://en.wikipedia.org/wiki/Alpha_shape) is used. If 0, the [convex hull](https://en.wikipedia.org/wiki/Convex_hull) is represented (resulting in a convex body).
@@ -72,7 +72,7 @@ fig.show()
72
72
73
73
[Dash](https://plotly.com/dash/) is the best way to build analytical apps in Python using Plotly figures. To run the app below, run `pip install dash`, click "Download" to get the code and run `python app.py`.
74
74
75
-
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
75
+
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash-enterprise/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
76
76
77
77
78
78
```python hide_code=true
@@ -146,7 +146,7 @@ fig = go.Figure(data=[
146
146
fig.show()
147
147
```
148
148
149
-
### Intensity values defined on vertices or cells
149
+
### Intensity Values Defined on Vertices or Cells
150
150
151
151
The `intensitymode` attribute of `go.Mesh3d` can be set to `vertex` (default mode, in which case intensity values are interpolated between values defined on vertices), or to `cell` (value of the whole cell, no interpolation). Note that the `intensity` parameter should have the same length as the number of vertices or cells, depending on the `intensitymode`.
Copy file name to clipboardExpand all lines: doc/python/3d-scatter-plots.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ jupyter:
33
33
thumbnail: thumbnail/3d-scatter.jpg
34
34
---
35
35
36
-
## 3D scatter plot with Plotly Express
36
+
## 3D Scatter Plot with Plotly Express
37
37
38
38
[Plotly Express](/python/plotly-express/) is the easy-to-use, high-level interface to Plotly, which [operates on a variety of types of data](/python/px-arguments/) and produces [easy-to-style figures](/python/styling-plotly-express/).
It is possible to customize the style of the figure through the parameters of `px.scatter_3d` for some options, or by updating the traces or the layout of the figure through `fig.update`.
[Dash](https://plotly.com/dash/) is the best way to build analytical apps in Python using Plotly figures. To run the app below, run `pip install dash`, click "Download" to get the code and run `python app.py`.
79
79
80
-
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
80
+
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash-enterprise/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
Copy file name to clipboardExpand all lines: doc/python/animations.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ jupyter:
34
34
thumbnail: thumbnail/animations.gif
35
35
---
36
36
37
-
#### Animated figures with Plotly Express
37
+
#### Animated Figures with Plotly Express
38
38
39
39
Several [Plotly Express](/python/plotly-express/) functions support the creation of animated figures through the `animation_frame` and `animation_group` arguments.
[Dash](https://plotly.com/dash/) is the best way to build analytical apps in Python using Plotly figures. To run the app below, run `pip install dash`, click "Download" to get the code and run `python app.py`.
54
54
55
-
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
55
+
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash-enterprise/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
56
56
57
57
58
58
```python hide_code=true
@@ -81,7 +81,7 @@ fig.show()
81
81
* Although Plotly Express supports animation for many chart and map types, smooth inter-frame transitions are today *only* possible for `scatter` and `bar`
82
82
* Plotly Express will *not* automatically compute the union of all x/y/color ranges, so these must be specified manually to avoid scale jumps across frames
83
83
84
-
#### Animated figures with Graph Objects
84
+
#### Animated Figures with Graph Objects
85
85
86
86
The remainder of this section describes the low-level [graph objects](/python/graph-objects/) API for constructing animated figures manually.
Copy file name to clipboardExpand all lines: doc/python/axes.md
+31-31Lines changed: 31 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -64,7 +64,7 @@ The axis type is auto-detected by looking at data from the first [trace](/python
64
64
* Both of these test an evenly-spaced sample of at most 1000 values
65
65
66
66
67
-
### Forcing an axis to be categorical
67
+
### Forcing an Axis to be Categorical
68
68
69
69
It is possible to force the axis type by setting explicitly `xaxis_type`. In the example below the automatic X axis type would be `linear` (because there are not more than twice as many unique strings as unique numbers) but we force it to be `category`.
70
70
@@ -91,7 +91,7 @@ The examples on this page apply to axes of any type, but extra attributes are av
91
91
92
92
#### Set and Style Axes Title Labels
93
93
94
-
##### Set axis title text with Plotly Express
94
+
##### Set Axis Title Text with Plotly Express
95
95
96
96
Axis titles are automatically set to the column names when [using Plotly Express with a data frame as input](/python/px-arguments/).
[Dash](https://plotly.com/dash/) is the best way to build analytical apps in Python using Plotly figures. To run the app below, run `pip install dash`, click "Download" to get the code and run `python app.py`.
130
130
131
-
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
131
+
Get started with [the official Dash docs](https://dash.plotly.com/installation) and **learn how to effortlessly [style](https://plotly.com/dash/design-kit/) & publish apps like this with <aclass="plotly-red"href="https://plotly.com/dash-enterprise/">Dash Enterprise</a> or <aclass="plotly-red"href="https://plotly.com/cloud/">Plotly Cloud</a>.**
Axis titles are set using the nested `title.text` property of the x or y axis. Here is an example of creating a new figure and using `update_xaxes` and `update_yaxes`, with magic underscore notation, to set the axis titles.
This example sets `standoff` attribute to cartesian axes to determine the distance between the tick labels and the axis title. Note that the axis title position is always constrained within the margins, so the actual standoff distance is always less than the set or default value. By default [automargin](https://plotly.com/python/setting-graph-size/#automatically-adjust-margins) is `True` in Plotly template for the cartesian axis, so the margins will be pushed to fit the axis title at given standoff distance.
194
194
@@ -213,7 +213,7 @@ fig.update_yaxes(
213
213
fig.show()
214
214
```
215
215
216
-
##### Set axis title font
216
+
##### Set Axis Title Font
217
217
218
218
Here is an example that configures the font family, size, and color for the axis titles in a figure created using Plotly Express.
219
219
@@ -230,7 +230,7 @@ fig.show()
230
230
231
231
#### Tick Placement, Color, and Style
232
232
233
-
##### Toggling axis tick marks
233
+
##### Toggling Axis Tick Marks
234
234
235
235
Axis tick marks are disabled by default for the default `plotly` theme, but they can easily be turned on by setting the `ticks` axis property to `"inside"` (to place ticks inside plotting area) or `"outside"` (to place ticks outside the plotting area).
The approximate number of ticks displayed for an axis can be specified using the `nticks` axis property.
253
253
@@ -263,7 +263,7 @@ fig.update_yaxes(nticks=20)
263
263
fig.show()
264
264
```
265
265
266
-
##### Set start position and distance between ticks
266
+
##### Set Start Position and Distance Between Ticks
267
267
268
268
The `tick0` and `dtick` axis properties can be used to control to placement of axis ticks as follows: If specified, a tick will fall exactly on the location of `tick0` and additional ticks will be added in both directions at intervals of `dtick`.
As discussed above, tick marks are disabled by default in the default `plotly` theme, but they can be enabled by setting the `ticks` axis property to `"inside"` (to place ticks inside plotting area) or `"outside"` (to place ticks outside the plotting area).
The orientation of the axis tick mark labels is configured using the `tickangle` axis property. The value of `tickangle` is the angle of rotation, in the clockwise direction, of the labels from vertical in units of degrees. The font family, size, and color for the tick labels are stored under the `tickfont` axis property.
The `showline` axis property controls the visibility of the axis line, and the `linecolor` and `linewidth` axis properties control the color and width of the axis line.
#### Setting only a Lower or Upper Bound for Range
692
+
#### Setting Only a Lower or Upper Bound for Range
693
693
694
694
*New in 5.17*
695
695
@@ -767,7 +767,7 @@ fig.update_yaxes(
767
767
fig.show()
768
768
```
769
769
770
-
### Fixed Ratio Axes with Compressed domain
770
+
### Fixed Ratio Axes with Compressed Domain
771
771
772
772
If an axis needs to be compressed (either due to its own `scaleanchor` and `scaleratio` or those of the other axis), `constrain` determines how that happens: by increasing the "range" (default), or by decreasing the "domain".
773
773
@@ -794,7 +794,7 @@ fig.update_yaxes(
794
794
fig.show()
795
795
```
796
796
797
-
##### Decreasing the domain spanned by an axis
797
+
##### Decreasing the Domain Spanned by an Axis
798
798
799
799
In the example below, the x and y axis are anchored together, and the range of the `xaxis` is set manually. By default, plotly extends the range of the axis (overriding the `range` parameter) to fit in the figure `domain`. You can restrict the `domain` to force the axis to span only the set range, by setting `constrain='domain'` as below.
The direction of an axis can be reversed when manually setting the range extents by specifying a list containing the upper bound followed by the lower bound (rather that the lower followed by the upper) as the `range` axis property.
If you are using a `log` type of axis and you want to set the range of the axis, you have to give the `log10` value of the bounds when using `fig.update_xaxes` or `fig.update_layout`. However, with `plotly.express` functions you pass directly the values of the range bounds (`plotly.express` then computes the appropriate values to pass to the figure layout).
#### Synchronizing axes in subplots with `matches`
931
+
#### Synchronizing Axes in Subplots with `matches`
932
932
933
933
Using `facet_col` from `plotly.express` let [zoom](https://help.plotly.com/zoom-pan-hover-controls/#step-3-zoom-in-and-zoom-out-autoscale-the-plot) and [pan](https://help.plotly.com/zoom-pan-hover-controls/#step-6-pan-along-axes) each facet to the same range implicitly. However, if the subplots are created with `make_subplots`, the axis needs to be updated with `matches` parameter to update all the subplots accordingly.
Use `autorangeoptions.include` to specify a value that should always be included within the calculated autorange. In this example, we specify that for the autorange calculated on the x-axis, 5 should be included.
0 commit comments