Treemap python #138

Mahdis-z · 2019-10-15T15:36:36Z

Doc upgrade checklist:

emmanuelle · 2019-10-16T14:19:42Z

python/treemap-charts.md

+
+### Basic Treemap
+
+Treemap chart visualize hierarchical data using nested rectangles. Same as [Sunburst](https://plot.ly/python/sunburst-charts/) the hierarchy is defined by [labels](https://plot.ly/python/reference/#treemap-labels) and [parents]((https://plot.ly/python/reference/#treemap-parents)) attributes. [count](https://plot.ly/python/reference/#treemap-count) attribute allows counting the numbers of leaves, branches or both when values array is not provided.


Please add a link to Wikipedia https://en.wikipedia.org/wiki/Treemapping

emmanuelle · 2019-10-16T14:32:27Z

python/treemap-charts.md

+fig.show()
+```
+
+### Advance Treemap


Treemap with several nested layers

(this code is actually not very complex, so I suggest to drop the "advanced")

emmanuelle · 2019-10-16T14:32:43Z

python/treemap-charts.md

+
+### Advance Treemap
+
+The following example uses hierarchical data that includes layers and grouping. Treemap and [Sunburst](https://plot.ly/python/sunburst-charts/) charts reveal indights into the data, and the format of your hierarchical data. 


indights --> insights

emmanuelle · 2019-10-16T14:34:14Z

python/treemap-charts.md

+
+fig = go.Figure()
+
+fig.add_trace(go.Treemap(


Could you use make_subplots here instead of domain? I think we're trying to push make_subplots as the preferred method to create subplots (and then you can add subtitles for example).

emmanuelle · 2019-10-16T14:45:27Z

python/treemap-charts.md

+
+### Set Different Attributes in Treemap
+
+This example uses the following attributs:


emmanuelle · 2019-10-16T14:47:05Z

python/treemap-charts.md

+
+This example uses the following attributs:
+
+ 1. [values](https://plot.ly/python/reference/#treemap-values): sets the values associated with each of the sunburst sectors


with each of the sectors (remove suburst)

emmanuelle · 2019-10-16T14:48:54Z

python/treemap-charts.md

+```python
+import plotly.graph_objects as go
+
+fig = go.Figure(go.Treemap(


same as below, could use make_subplots?

emmanuelle · 2019-10-16T14:50:56Z

python/treemap-charts.md

+### Basic Treemap
+
+Treemap chart visualize hierarchical data using nested rectangles. Same as [Sunburst](https://plot.ly/python/sunburst-charts/) the hierarchy is defined by [labels](https://plot.ly/python/reference/#treemap-labels) and [parents]((https://plot.ly/python/reference/#treemap-parents)) attributes. [count](https://plot.ly/python/reference/#treemap-count) attribute allows counting the numbers of leaves, branches or both when values array is not provided.
+


Please explain here how to interact with the treemap chart: click on one sector to zoom (mention the pathbar), and double-click to zoom out one level.

yeah, I add how to zoom in with click... to zoom out we basically use 'pathbar'.. double click is doing the same thing that click does.

For me (Chrome) double clicking zooms out one level, is it the same for you?

emmanuelle · 2019-10-16T14:53:47Z

python/treemap-charts.md

+import plotly.graph_objects as go
+
+fig = go.Figure(go.Treemap(
+    labels = ["Eve", "Cain", "Seth", "Enos", "Noam", "Abel", "Awan", "Enoch", "Azura"],


define labels and parents variables before defining the traces to show it's the same data used for the two traces?

To kinda show the possibility of plotting Treemap with defining only these 2 attributes, make sense?

no sorry, this is not what I meant: since it's the same values for the two traces for labels and parents I was suggesting to define variables to hold these values to reduce code duplication and to show what is similar in the two traces

emmanuelle · 2019-10-16T14:54:49Z

python/treemap-charts.md

+    marker = {"line": {"width": 2}},
+    pathbar = {"visible": False}))
+
+fig.update_layout(


with subplots you could use subtitles here which would be more readable

emmanuelle · 2019-10-16T14:58:57Z

Is it possible to add an example showing how to control the color of Treemap sectors? (From a rapid scroll through the docstring I did not find the answer so this would be all the more useful ;-))

emmanuelle · 2019-10-16T14:59:44Z

python/treemap-charts.md

+```python
+import plotly.graph_objects as go
+
+fig = go.Figure()


When we have one single trace we prefer the more compact syntax

fig = go.Figure(go.Treemap(...))

emmanuelle · 2019-10-16T15:01:32Z

About using make_subplots, did you use domain instead because make_subplots is more difficult to use for non-Cartesian axes?

emmanuelle · 2019-10-16T15:04:13Z

python/treemap-charts.md

+    pygments_lexer: ipython3
+    version: 3.7.3
+  plotly:
+    description: How to make Treemap Charts.


.. with plotly

emmanuelle · 2019-10-16T15:04:57Z

python/treemap-charts.md

+    order: 14
+    page_type: u-guide
+    permalink: python/treemap-charts/
+    thumbnail: thumbnail/treemap.png


is this a new thumbnail or the old one?

A new thumbnail

emmanuelle · 2019-10-16T15:06:34Z

python/treemap-charts.md

+
+### Basic Treemap
+
+Treemap chart visualize hierarchical data using nested rectangles. Same as [Sunburst](https://plot.ly/python/sunburst-charts/) the hierarchy is defined by [labels](https://plot.ly/python/reference/#treemap-labels) and [parents]((https://plot.ly/python/reference/#treemap-parents)) attributes. [count](https://plot.ly/python/reference/#treemap-count) attribute allows counting the numbers of leaves, branches or both when values array is not provided.


chart --> charts
Same as -- As for

I would leave the explanation about count for later in the tutorial since it's not used in the example just below

nicolaskruchten · 2019-10-16T16:52:54Z

python/treemap-charts.md

+    name: Treemap Charts
+    order: 14
+    page_type: u-guide
+    permalink: python/treemap-charts/


This permalink should be the same as the file you're deleting in the other PR, so we inherit all the traffic from the previous page!

(and the filename should match)

in fact, it would be best if the deletion and upgrade were in the same PR :)

This permalink should be the same as the file you're deleting in the other PR, so we inherit all the traffic from the previous page!

good point, I changed it to be similar to other charts name!

emmanuelle · 2019-10-16T19:37:37Z

Nicolas showed me that the color is controlled by marker.colors.

emmanuelle · 2019-10-17T14:53:39Z

One thing which you might do another time is to do a git mv treemap-chart.md treemap.md so that we would still see the comments in the file you've updated :-). Can you also do git rm treemap-chart.md now that it's not needed?

emmanuelle · 2019-10-17T15:27:45Z

python/treemaps.md

+    parents = parents,
+    values =  [10, 14, 12, 10, 2, 6, 6, 1, 4],
+    textinfo = "label+value+percent parent+percent entry+percent root",
+    pathbar = {"visible": False}), 


It was a smart trick to disable the pathbar because of the overflow but the pathbar is super useful for navigation. What I tried is adding a blank line in the titles like branchvalues: <b>remainder</b><br> <br>', a bit ugly but it does the trick (you can add a comment in the code cell to explain that it's a workaround for now)

emmanuelle · 2019-10-17T15:33:58Z

python/treemaps.md

+fig.show()
+```
+
+### Set Color of Sectors


Set Color of Treemap Sectors

(I think we want to repeat the chart name as much as possible for search engines)

emmanuelle · 2019-10-17T15:34:51Z

python/treemaps.md

+
+### Set Color of Sectors
+
+There are three different ways to change the color of the sectors in Treemap:


Nice examples about colors, thanks for adding them! I would never have found the 3 ways myself 😆

emmanuelle · 2019-10-17T15:35:37Z

python/treemaps.md

+fig = go.Figure(go.Treemap(
+    labels = labels,
+    parents = parents,
+    marker = {'colors': ["pink", "royalblue", "lightgray", "purple", "cyan", "lightgray", "lightblue"]}))


very minor style remark, but can you use the shorter syntax marker_colors here? We're trying to push the magic underscore as much as possible :-)

Yeah, good point

emmanuelle · 2019-10-17T15:35:57Z

python/treemaps.md

+    labels = labels,
+    values = values,
+    parents = parents,
+    marker = {"colorscale": "Blues"}))


marker_colorscale for more magic underscore :-)

emmanuelle · 2019-10-17T15:36:25Z

python/treemaps.md

+### Nested Layers in Treemap
+
+The following example uses hierarchical data that includes layers and grouping. Treemap and [Sunburst](https://plot.ly/python/sunburst-charts/) charts reveal insights into the data, and the format of your hierarchical data. 
+


Could you please add a sentence about maxdepth here?

emmanuelle · 2019-10-17T15:37:06Z

Thanks for the update! I left a couple of comments and after this we should be good to go :-)

emmanuelle · 2019-10-17T17:23:01Z

Could you also update the plotly.py version in the requirements.txt with the new release to make CircleCI happy?

emmanuelle · 2019-10-17T17:25:20Z

💃 once the CI is happy (bumping up plotly.py in requirements.txt should do the job I hope)

emmanuelle · 2019-10-17T18:33:33Z

💃 !

Mahdis-z requested a review from nicolaskruchten October 15, 2019 15:39

emmanuelle reviewed Oct 16, 2019

View reviewed changes

nicolaskruchten reviewed Oct 16, 2019

View reviewed changes

emmanuelle reviewed Oct 17, 2019

View reviewed changes

“mahdis-z” added 4 commits October 17, 2019 14:12

new tutorial for treemap.py

f4f05f3

few settings modified

48e1004

ipynb

f9a619c

more examples added

5d0e77a

“mahdis-z” added 3 commits October 17, 2019 14:12

final revision

472aaaf

some minor changes

2e7c4cc

update requirement.txt

2fd565e

Mahdis-z force-pushed the _treemap_python branch from 8b928d1 to 2fd565e Compare October 17, 2019 18:23

Mahdis-z merged commit 7177840 into master Oct 17, 2019

Mahdis-z deleted the _treemap_python branch October 17, 2019 18:42


		### Basic Treemap

		Treemap chart visualize hierarchical data using nested rectangles. Same as [Sunburst](https://plot.ly/python/sunburst-charts/) the hierarchy is defined by [labels](https://plot.ly/python/reference/#treemap-labels) and [parents]((https://plot.ly/python/reference/#treemap-parents)) attributes. [count](https://plot.ly/python/reference/#treemap-count) attribute allows counting the numbers of leaves, branches or both when values array is not provided.


		### Advance Treemap

		The following example uses hierarchical data that includes layers and grouping. Treemap and [Sunburst](https://plot.ly/python/sunburst-charts/) charts reveal indights into the data, and the format of your hierarchical data.


		### Set Different Attributes in Treemap

		This example uses the following attributs:


		This example uses the following attributs:

		1. [values](https://plot.ly/python/reference/#treemap-values): sets the values associated with each of the sunburst sectors


		### Set Color of Sectors

		There are three different ways to change the color of the sectors in Treemap:

		### Nested Layers in Treemap

		The following example uses hierarchical data that includes layers and grouping. Treemap and [Sunburst](https://plot.ly/python/sunburst-charts/) charts reveal insights into the data, and the format of your hierarchical data.


		fig = go.Figure()

		fig.add_trace(go.Treemap(

Treemap python #138

Treemap python #138

Uh oh!

Conversation

Mahdis-z commented Oct 15, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

emmanuelle commented Oct 16, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

emmanuelle commented Oct 16, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

emmanuelle commented Oct 16, 2019

Uh oh!

emmanuelle commented Oct 17, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

emmanuelle commented Oct 17, 2019

Uh oh!