Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Sunburst Chart

Signature

sp.build_sunburst(
    title: str,
    labels: list[str],
    parents: list[str],
    values: list[float],
    *,
    width: int = 700,
    height: int = 480,
    palette: list[int] | None = None,
    background: str | None = None,
    hover_json: str | None = None,
) -> Chart

Aliases: sp.sunburst


Description

Hierarchical sunburst chart. Nodes are arranged in concentric rings radiating outward from the root.

The labels and parents lists define a tree: each entry in labels[i] has parents[i] as its parent ("" for root nodes). values controls arc size.


Parameters

ParameterTypeDefaultDescription
titlestrrequiredChart title
labelslist[str]requiredNode labels
parentslist[str]requiredParent label per node ("" = root)
valueslist[float]requiredNode size values
widthint700Canvas width
heightint480Canvas height
palettelist[int] | NoneNoneCustom colors
backgroundstr | NoneNoneBackground color
hover_jsonstr | NoneNoneCustom hover JSON

Returns

Chart


Examples

Company org chart

import seraplot as sp
labels  = ["Corp", "Sales", "Tech", "HR", "B2B", "B2C", "Frontend", "Backend"]
parents = ["",       "Corp", "Corp","Corp","Sales","Sales","Tech",    "Tech"]
values  = [1,        40,     50,    10,    25,     15,     30,        20]
chart = sp.build_sunburst(
    "Headcount by Department",
    labels=labels,
    parents=parents,
    values=values,
)
const sp = require('seraplot');
const labels  = ["Corp", "Sales", "Tech", "HR", "B2B", "B2C", "Frontend", "Backend"]
const parents = ["",       "Corp", "Corp","Corp","Sales","Sales","Tech",    "Tech"]
const values  = [1,        40,     50,    10,    25,     15,     30,        20]
const chart = sp.build_sunburst("Headcount by Department",
labels,
parents,
{
    values: values
})
import * as sp from 'seraplot';
const labels: string[] = ["Corp", "Sales", "Tech", "HR", "B2B", "B2C", "Frontend", "Backend"]
const parents: string[] = ["",       "Corp", "Corp","Corp","Sales","Sales","Tech",    "Tech"]
const values: number[] = [1,        40,     50,    10,    25,     15,     30,        20]
const chart = sp.build_sunburst("Headcount by Department",
labels,
parents,
{
    values: values
})
▶ Live Preview

See also

Signature

sp.build_sunburst(
    title: str,
    labels: list[str],
    parents: list[str],
    values: list[float],
    *,
    width: int = 700,
    height: int = 480,
    palette: list[int] | None = None,
    background: str | None = None,
    hover_json: str | None = None,
) -> Chart

Aliases: sp.sunburst


Description

Graphique sunburst hiérarchique. Les nœuds sont disposés en anneaux concentriques rayonnant depuis la racine.

labels[i] a parents[i] comme parent ("" pour les nœuds racine). values contrôle la taille des arcs.


Paramètres

ParamètreTypeDéfautDescription
titlestrrequisTitre du graphique
labelslist[str]requisÉtiquettes des nœuds
parentslist[str]requisParent de chaque nœud ("" = racine)
valueslist[float]requisValeurs de taille des nœuds
widthint700Largeur du canvas
heightint480Hauteur du canvas
palettelist[int] | NoneNoneCouleurs personnalisées
backgroundstr | NoneNoneCouleur de fond
hover_jsonstr | NoneNoneJSON d'infobulle personnalisée

Retourne

Chart


Exemples

import seraplot as sp

labels  = ["Société", "Ventes", "Tech", "RH", "B2B", "B2C", "Frontend", "Backend"]
parents = ["",         "Société", "Société", "Société", "Ventes", "Ventes", "Tech", "Tech"]
values  = [1,           40,       50,     10,   25,     15,     30,        20]

chart = sp.build_sunburst(
    "Effectifs par département",
    labels=labels,
    parents=parents,
    values=values,
)

Voir aussi