Gauge - Single-Value Arc Indicator
Signature
sp.gauge(title, *, value, min_val=0.0, max_val=100.0, label="", variant="basic", comparison=0.0, **kwargs) -> Chart
Description
sp.gauge() is the unified entry point for the gauge family. A gauge maps a single scalar to a colored arc with optional thresholds - perfect for status / health / utilization KPIs. The variant keyword switches the geometry (half, three-quarter, full ring), the embellishments (needle, ticks, glow) and the layering (single arc vs. concentric arcs for value-vs-target).
Parameters
| Parameter | Used by variants |
|---|---|
comparison | concentric |
max_val | arc270, concentric, tick |
min_val | arc270, tick |
value | concentric, sleek |
Returns
Chart - object with .html property and .show() method.
Signature
sp.gauge(title, *, value, min_val=0.0, max_val=100.0, label="", variant="basic", comparison=0.0, **kwargs) -> Chart
Description
sp.gauge() est le point d entree unique pour la famille jauge. Une jauge associe un scalaire unique a un arc colore avec des seuils optionnels - parfait pour des KPIs de statut / sante / utilisation. Le mot-cle variant change la geometrie (demi, trois-quart, anneau complet), les ornements (aiguille, ticks, glow) et la composition (arc simple ou arcs concentriques pour valeur-vs-cible).
Parametres
| Parametre | Type | Defaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
value | float | requis | Valeur courante a afficher |
min_val | float | 0.0 | Minimum de l echelle |
max_val | float | 100.0 | Maximum de l echelle |
variant | str | "basic" | Style visuel (voir tableau) |
label | str | "" | Sous-libelle sous la valeur |
comparison | float | 0.0 | Valeur de comparaison (pour concentric) |
seuils | list[(float,int)] | None | [(value, color_hex), ...] seuils |
width | int | 400 | Largeur (px) |
height | int | 300 | Hauteur (px) |
Retour
Chart - objet avec propriete .html et methode .show().