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).
Variants
Parameters
Returns
Chart — object with .html property and .show() method.
Classic squarified treemap with rounded corners and white separators between tiles.
Edge-to-edge mosaic with no stroke and no rounding for a dense, magazine-style block.
Wireframe tiles: translucent fill with bold colored stroke and dark labels for print-ready look.
Each tile inset with extra padding so the structure breathes; rounded corners and color fill.
Draws parent group rectangles with header labels around their children, emphasising hierarchy.
Color encodes value (cool blue -> hot red) instead of identity, turning the treemap into a heatmap.
Single hue with opacity decreasing by rank; editorial, minimalist, perfect for slides.
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).
Variantes
Paramètres
Retour
Chart — objet avec une propriete .html et une methode .show().
Treemap squarifie classique avec coins arrondis et separateurs blancs entre les tuiles.
Mosaique bord-a-bord sans contour ni arrondi pour un bloc dense type magazine.
Tuiles en fil de fer : fond translucide, contour colore epais et libelles sombres, style imprimable.
Chaque tuile en retrait avec marges supplementaires pour aerer la structure ; coins arrondis.
Dessine les rectangles parents avec libelle d en-tete autour de leurs enfants, met en avant la hierarchie.
La couleur code la valeur (bleu froid -> rouge chaud) au lieu de l identite, treemap en heatmap.
Teinte unique avec opacite decroissante par rang ; minimaliste et editorial, ideal pour slides.