Sunburst — Hierarchical Ring Chart
Signature
sp.sunburst(title, labels, parents, values, *, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.sunburst() is the unified entry point for the entire sunburst-chart family. A sunburst represents a hierarchy as concentric rings: the innermost ring is the root, each outer ring is a deeper level, and angular size encodes value. The variant keyword selects the visual style without changing any other parameter. Sunbursts are the standard for visualizing nested taxonomies (org charts, file systems, market segmentation, expense categories, phylogenetic trees) and outperform classic pie charts as soon as a real hierarchy exists.
Hierarchy encoding —
labelslists every node,parentsgives the parent label of each node ("" for a root). Leaf values are taken fromvalues; internal node values are auto-rolled-up from descendants when set to 0.
Variants
Parameters
Returns
Chart — object with .html property and .show() method.
Classic concentric rings with depth-based opacity and white separators.
Larger central hole with the formatted grand total displayed at the center.
Wireframe wedges: white fill + colored stroke that thins on deeper rings.
Angular and radial margins between every wedge for crisp petal-like separation.
Standard palette but opacity decreases with depth, focusing the eye on top levels.
Single-color rings differentiated only by depth-based opacity. Editorial look.
Click a ring segment to zoom into that branch, animating every other segment to its new angle/radius. Click the center to zoom back out.
Signature
sp.sunburst(title, labels, parents, values, *, variant="basic", palette=None, **kwargs) -> Chart
Description
sp.sunburst() est le point d entree unifie pour toute la famille des graphiques sunburst. Un sunburst represente une hierarchie sous forme d anneaux concentriques : l anneau interieur est la racine, chaque anneau exterieur est un niveau plus profond, et l angle code la valeur. Le mot-cle variant change le style sans toucher aux autres parametres. Les sunbursts sont la reference pour visualiser des taxonomies imbriquees (organigrammes, systemes de fichiers, segmentation marche, categories de depenses, arbres phylogenetiques) et surpassent le camembert des qu une vraie hierarchie existe.
Encodage de la hierarchie —
labelsliste tous les noeuds,parentsdonne le libelle du parent de chaque noeud ("" pour une racine). Les valeurs des feuilles viennent devalues; les noeuds internes a 0 sont calcules automatiquement comme la somme de leurs descendants.
Variantes
Paramètres
Retour
Chart — objet avec une propriete .html et une methode .show().
Anneaux concentriques classiques avec opacite degressive selon la profondeur.
Large trou central avec total general formate (k/M) au centre.
Quartiers en fil de fer : fond blanc + contour colore amincissant en profondeur.
Marges angulaires et radiales entre quartiers pour une separation nette en petales.
Palette standard mais opacite decroissante en profondeur pour concentrer le regard.
Anneaux monochromes differencies uniquement par opacite. Rendu editorial.
Cliquer un segment zoome sur cette branche, en animant chaque autre segment vers son nouvel angle/rayon. Cliquer le centre pour dezoomer.