Treemap — Hierarchical Proportional Tiles
Signature
sp.treemap(title, labels, values, *, parents=None, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.treemap() is the unified entry point for the entire treemap-chart family. A treemap divides a rectangle into proportional sub-rectangles whose area encodes value; when a parents list is given the layout becomes hierarchical (each parent gets its own block, leaves are squarified within). The variant keyword switches the visual style without touching the data. Treemaps are the standard for visualizing budgets, market cap, disk usage, portfolio weights, file systems and any 'whole = sum of parts' breakdown.
Hierarchical mode — pass
parents(one parent label per leaf, can be empty string""for a flat treemap). Internal totals are auto-computed from leaves. Sort leaves with thesort_orderparameter ("desc"recommended).
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Tile labels (one per leaf) |
values | list[float] | required | Leaf values (area) |
parents | list[str] | None | Parent label of each leaf ("" -> flat) |
variant | str | "basic" | Visual style (see table) |
palette | list[int] | None | Custom color palette (per parent or per tile) |
sort_order | str | "none" | "none", "asc" or "desc" for leaves |
width | int | 1100 | Canvas width (px) |
height | int | 520 | Canvas height (px) |
Returns
Chart — object with .html property and .show() method.
Signature
sp.treemap(title, labels, values, *, parents=None, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.treemap() est le point d entree unifie pour toute la famille treemap. Un treemap decoupe un rectangle en sous-rectangles proportionnels dont l aire code la valeur ; lorsqu une liste parents est fournie le rendu devient hierarchique (chaque parent recoit son propre bloc, les feuilles y sont squarifiees). Le mot-cle variant change le style sans toucher aux donnees. Les treemaps sont la reference pour visualiser budgets, capitalisations boursieres, occupation disque, poids de portefeuille, systemes de fichiers et toute decomposition 'tout = somme des parties'.
Mode hierarchique — passez
parents(un libelle parent par feuille, chaine vide""pour un treemap plat). Les totaux internes sont auto-calcules. Triez les feuilles avecsort_order("desc"recommande).
Parametres
| Parametre | Type | Defaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Libelles des tuiles (un par feuille) |
values | list[float] | requis | Valeurs feuilles (aire) |
parents | list[str] | None | Parent de chaque feuille ("" -> plat) |
variant | str | "basic" | Style visuel (voir tableau) |
palette | list[int] | None | Palette de couleurs (par parent ou tuile) |
sort_order | str | "none" | "none", "asc" ou "desc" pour les feuilles |
width | int | 1100 | Largeur du canvas (px) |
height | int | 520 | Hauteur du canvas (px) |
Retour
Chart — objet avec une propriete .html et une methode .show().