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
You can add the `z` values as text to 2D Histogram points using `fig.update_traces(texttemplate="%{z}")`
85
+
### Displaying Text
86
+
87
+
*New in v5.5*
88
+
89
+
You can add the `z` values as text using the `text_auto` argument. Setting it to `True` will display the values on the bars, and setting it to a `d3-format` formatting string will control the output format.
Copy file name to clipboardExpand all lines: doc/python/annotated-heatmap.md
+43-127
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ jupyter:
8
8
format_version: '1.3'
9
9
jupytext_version: 1.13.4
10
10
kernelspec:
11
-
display_name: Python 3 (ipykernel)
11
+
display_name: Python 3
12
12
language: python
13
13
name: python3
14
14
language_info:
@@ -20,7 +20,7 @@ jupyter:
20
20
name: python
21
21
nbconvert_exporter: python
22
22
pygments_lexer: ipython3
23
-
version: 3.7.11
23
+
version: 3.8.11
24
24
plotly:
25
25
description: How to make Annotated Heatmaps in Python with Plotly.
26
26
display_as: scientific
@@ -34,9 +34,11 @@ jupyter:
34
34
thumbnail: thumbnail/ann_heat.jpg
35
35
---
36
36
37
-
### Annotated Heatmaps with plotly.express and px.imshow
37
+
### Annotated Heatmaps with Plotly Express
38
38
39
-
These examples use [px.imshow](/python/imshow) to create Annotated Heatmaps. px.imshow is the recommended way to create heatmaps with z-annotations.
39
+
*New in v5.5*
40
+
41
+
As of version 5.5.0 of `plotly`, the **recommended way to [display annotated heatmaps is to use `px.imshow()`](/python/heatmaps/)** rather than the now-deprecated `create_annotated_heatmap` figure factory documented below for historical reasons.
40
42
41
43
42
44
#### Basic Annotated Heatmap for z-annotations
@@ -46,33 +48,19 @@ After creating a figure with `px.imshow`, you can add z-annotations with `.updat
46
48
```python
47
49
import plotly.express as px
48
50
49
-
df = px.data.medals_wide(indexed=True)
50
-
51
-
fig = px.imshow(df)
52
-
fig.update_traces(texttemplate="%{z}")
53
-
54
-
fig.show()
55
-
```
56
-
57
-
#### Custom Font
58
-
59
-
You can make changes to the font using `textfont`. Here we set the font size to 20.
60
-
61
-
```python
62
-
import plotly.express as px
63
-
64
-
df = px.data.medals_wide(indexed=True)
65
-
66
-
fig = px.imshow(df)
67
-
fig.update_traces(texttemplate="%{z}")
68
-
fig.update_traces(textfont={"size":20})
51
+
z = [[.1, .3, .5, .7, .9],
52
+
[1, .8, .6, .4, .2],
53
+
[.2, 0, .5, .7, .9],
54
+
[.9, .8, .4, .2, 0],
55
+
[.3, .4, .5, .7, 1]]
69
56
57
+
fig = px.imshow(z, text_auto=True)
70
58
fig.show()
71
59
```
72
60
73
-
### Annotated Heatmaps with [figure factory](/python/figure-factories/). For more examples with Heatmaps, see [this page](/python/heatmaps/).
61
+
### Deprecated Figure Factory
74
62
75
-
The remaining examples show how to create Annotated Heatmaps with [figure factory](/python/figure-factories/). For more examples with Heatmaps, see [this page](/python/heatmaps/).
63
+
The remaining examples show how to create Annotated Heatmaps with the deprecated `create_annotated_heatmap`[figure factory](/python/figure-factories/).
set `annotation_text` to a matrix with the same dimensions as `z`
83
+
84
+
> WARNING: this legacy figure factory requires the `y` array to be provided in reverse order, and will map the `z_text` to the `z` values in reverse order. **The use of the `px.imshow()` version below is highly recommended**
The bar plot can be customized using keyword arguments, for example to use [continuous color](https://plotly.com/python/colorscales/), as below, or [discrete color](/python/discrete-color/), as above.
You can add text to bars using the `text_auto` argument. Setting it to `True` will display the values on the bars, and setting it to a `d3-format` formatting string will control the output format.
Use the keyword arguments `facet_row` (resp. `facet_col`) to create facetted subplots, where different rows (resp. columns) correspond to different values of the dataframe column specified in `facet_row`.
Copy file name to clipboardExpand all lines: doc/python/figure-factories.md
+8-4
Original file line number
Diff line number
Diff line change
@@ -5,8 +5,8 @@ jupyter:
5
5
text_representation:
6
6
extension: .md
7
7
format_name: markdown
8
-
format_version: '1.2'
9
-
jupytext_version: 1.3.1
8
+
format_version: '1.3'
9
+
jupytext_version: 1.13.4
10
10
kernelspec:
11
11
display_name: Python 3
12
12
language: python
@@ -20,7 +20,7 @@ jupyter:
20
20
name: python
21
21
nbconvert_exporter: python
22
22
pygments_lexer: ipython3
23
-
version: 3.6.8
23
+
version: 3.8.11
24
24
plotly:
25
25
description: Figure Factories are dedicated functions for creating very specific
26
26
types of plots.
@@ -39,7 +39,6 @@ The `plotly.figure_factory` module contains dedicated functions for creating ver
39
39
40
40
The following types of plots are still difficult to create with Graph Objects or Plotly Express and therefore the corresponding Figure Factories are *not* deprecated:
@@ -50,10 +49,15 @@ The following types of plots are still difficult to create with Graph Objects or
50
49
51
50
Deprecated "legacy" Figure Factories include:
52
51
52
+
*[Annotated Heatmaps](/python/annotated-heatmap/), deprecated by [heatmaps with `px.imshow()`](/python/heatmaps/)
53
53
*[County Choropleth Maps](/python/county-choropleth/), deprecated by regular [Choropleth maps with GeoJSON input](/python/choropleth-maps/)
54
54
*[Distplots](/python/distplot/), mostly deprecated by [`px.histogram`](/python/histograms/) except for KDE plots, which `px.histogram` doesn't support yet
55
55
*[Gantt Charts](/python/gantt/), deprecated by [`px.timeline`](/python/gantt/)
56
56
57
57
#### Reference
58
58
59
59
For more information about the contents of `plotly.figure_factory`, including deprecated methods, please refer to our [API Reference documentation](https://plotly.com/python-api-reference/plotly.figure_factory.html).
0 commit comments