Treemap
Signature
sp.build_treemap(
title: str,
labels: list[str],
values: list[float],
*,
parents: list[str] | None = None,
width: int = 900,
height: int = 480,
palette: list[int] | None = None,
background: str | None = None,
hover_json: str | None = None,
) -> Chart
Aliases: sp.treemap
Description
Treemap — square-based space-filling hierarchy visualization. Tiles are sized proportionally to their value.
When parents is provided, the hierarchy is rendered as nested rectangles.
Without parents, a flat treemap is drawn.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Tile labels |
values | list[float] | required | Tile sizes |
parents | list[str] | None | None | Optional parent labels for hierarchy |
width | int | 900 | Canvas width |
height | int | 480 | Canvas height |
palette | list[int] | None | None | Custom color palette |
background | str | None | None | Background color |
hover_json | str | None | None | Custom hover JSON |
Returns
Chart
Examples
Flat treemap (market cap)
Hierarchical treemap
import seraplot as sp
labels = ["Electronics", "Phones", "Laptops", "Clothing", "Shirts", "Pants"]
parents = ["", "Electronics","Electronics","","Clothing","Clothing"]
values = [1, 400, 350, 1, 200, 150]
chart = sp.build_treemap(
"Revenue by Category",
labels=labels,
values=values,
parents=parents,
)const sp = require('seraplot');
const labels = ["Electronics", "Phones", "Laptops", "Clothing", "Shirts", "Pants"]
const parents = ["", "Electronics","Electronics","","Clothing","Clothing"]
const values = [1, 400, 350, 1, 200, 150]
const chart = sp.build_treemap("Revenue by Category",
labels,
{
values: values,
parents: parents
})import * as sp from 'seraplot';
const labels: string[] = ["Electronics", "Phones", "Laptops", "Clothing", "Shirts", "Pants"]
const parents: string[] = ["", "Electronics","Electronics","","Clothing","Clothing"]
const values: number[] = [1, 400, 350, 1, 200, 150]
const chart = sp.build_treemap("Revenue by Category",
labels,
{
values: values,
parents: parents
})▶ Live Preview
See also
Signature
sp.build_treemap(
title: str,
labels: list[str],
values: list[float],
*,
parents: list[str] | None = None,
width: int = 900,
height: int = 480,
palette: list[int] | None = None,
background: str | None = None,
hover_json: str | None = None,
) -> Chart
Aliases: sp.treemap
Description
Treemap — visualisation hiérarchique à base de rectangles. Les tuiles sont proportionnelles à leur valeur. Avec parents, rendu en rectangles imbriqués. Sans parents, treemap plat.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Étiquettes des tuiles |
values | list[float] | requis | Tailles des tuiles |
parents | list[str] | None | None | Étiquettes parents optionnelles pour la hiérarchie |
width | int | 900 | Largeur du canvas |
height | int | 480 | Hauteur du canvas |
palette | list[int] | None | None | Palette de couleurs |
background | str | None | None | Couleur de fond |
hover_json | str | None | None | JSON d'infobulle personnalisée |
Retourne
Chart
Exemples
Treemap hiérarchique
import seraplot as sp
labels = ["Electronique", "Téléphones", "Portables", "Vêtements", "Chemises", "Pantalons"]
parents = ["", "Electronique","Electronique","","Vêtements","Vêtements"]
values = [1, 400, 350, 1, 200, 150]
chart = sp.build_treemap(
"Chiffre d'affaires par catégorie",
labels=labels,
values=values,
parents=parents,
)