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.
Treemap + period-over-period change fusion: pass comparisons (prior-period values, aligned with values) and every tile big enough gets a small colored badge (▲/▼ + %) in its corner — the Finviz-style "market map" look, natively.
Real Voronoi treemap: a weighted power diagram is relaxed over many iterations until each organic polygon's area matches its value, no rectangles involved. Pass parents to split the disc into value-sized angular sectors (first sector gets full category color via categories plus an optional hatch flag via categories2; every other sector renders in neutral gray) — built for "how much of the whole is in this hazardous/flagged/priority group" breakdowns.
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.
Fusion treemap + variation d'une periode a l'autre : passez comparisons (valeurs de la periode precedente, alignees avec values) et chaque case assez grande recoit un petit badge colore (▲/▼ + %) dans son coin — le look "market map" façon Finviz, nativement.
Un vrai treemap de Voronoi : un diagramme de puissance pondere est relaxe sur de nombreuses iterations jusqu a ce que l aire de chaque polygone organique corresponde a sa valeur, sans le moindre rectangle. Passez parents pour decouper le disque en secteurs angulaires proportionnels a leur valeur (le premier secteur recoit la couleur de categorie via categories plus un hachurage optionnel via categories2 ; tous les autres secteurs restent gris neutre) — concu pour les repartitions du type "quelle part de l ensemble est dangereuse/marquee/prioritaire".