Donut Chart
Signature
sp.build_donut_chart(
title: str,
labels: list[str],
values: list[float],
*,
show_pct: bool = True,
inner_radius_ratio: float = 0.55,
width: int = 700,
height: int = 480,
palette: list[int] | None = None,
background: str | None = None,
hover_json: str | None = None,
legend_position: str = "right",
) -> Chart
Aliases: sp.donut, sp.donut_chart
Description
Donut chart — identical to a pie chart with a circular hole at the center.
Diagramme en anneau — comme un camembert mais avec un trou circulaire au centre.
The inner_radius_ratio controls what fraction of the radius is the hole (0.0 = solid pie, 1.0 = invisible ring).
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Slice labels |
values | list[float] | required | Slice values |
show_pct | bool | True | Show percentage labels |
inner_radius_ratio | float | 0.55 | Hole size (0.0–0.9) |
width | int | 700 | Canvas width in pixels |
height | int | 480 | Canvas height in pixels |
palette | list[int] | None | None | Custom hex color palette |
background | str | None | None | Chart background |
hover_json | str | None | None | Custom hover tooltip JSON |
legend_position | str | "right" | Legend position |
Returns
Chart
Examples
Basic donut
import seraplot as sp
chart = sp.build_donut_chart(
"Budget Allocation",
labels=["R&D", "Marketing", "Operations", "Support"],
values=[35, 25, 30, 10],
inner_radius_ratio=0.55,
show_pct=True,
)const sp = require('seraplot');
const chart = sp.build_donut_chart("Budget Allocation",
["R&D", "Marketing", "Operations", "Support"],
{
values: [35, 25, 30, 10],
inner_radius_ratio: 0.55,
show_pct: true
})import * as sp from 'seraplot';
const chart = sp.build_donut_chart("Budget Allocation",
["R&D", "Marketing", "Operations", "Support"],
{
values: [35, 25, 30, 10],
inner_radius_ratio: 0.55,
show_pct: true
})▶ Live Preview
See also
Signature
sp.build_donut_chart(
title: str,
labels: list[str],
values: list[float],
*,
show_pct: bool = True,
inner_radius_ratio: float = 0.55,
width: int = 700,
height: int = 480,
palette: list[int] | None = None,
background: str | None = None,
hover_json: str | None = None,
legend_position: str = "right",
) -> Chart
Aliases: sp.donut, sp.donut_chart
Description
Diagramme en anneau — identique à un camembert avec un trou circulaire central. inner_radius_ratio contrôle la taille du trou (0.0 = camembert plein, 1.0 = anneau invisible).
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Étiquettes des tranches |
values | list[float] | requis | Valeurs des tranches |
show_pct | bool | True | Afficher les pourcentages |
inner_radius_ratio | float | 0.55 | Taille du trou (0.0–0.9) |
width | int | 700 | Largeur du canvas en pixels |
height | int | 480 | Hauteur du canvas en pixels |
palette | list[int] | None | None | Palette de couleurs hex |
background | str | None | None | Fond du graphique |
hover_json | str | None | None | JSON d'infobulle personnalisée |
legend_position | str | "right" | Position de la légende |
Retourne
Chart
Exemples
import seraplot as sp
chart = sp.build_donut_chart(
"Répartition du budget",
labels=["R&D", "Marketing", "Opérations", "Support"],
values=[35, 25, 30, 10],
inner_radius_ratio=0.55,
show_pct=True,
)