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).
Variants
Parameters
Returns
Chart - object with .html property and .show() method.
Half-circle gauge with needle and color thresholds - the speedometer everyone knows.
Full-circle donut progress arc - elegant ring KPI for dashboards.
270-degree arc - more arc length for finer reading than a half-circle.
No needle, no ticks - oversized value text on a clean colored arc.
Half-arc with ruler tick marks every 5% and major labels every 25%.
Battery / signal-bar style with discrete chunks lighting up by threshold.
Neon glow effect on the active arc - dramatic dark dashboard look.
Two concentric arcs: outer = current, inner = comparison or target.
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).
Variantes
Paramètres
Retour
Chart - objet avec propriete .html et methode .show().
Jauge demi-cercle avec aiguille et seuils colores - le compteur que tout le monde connait.
Arc de progression circulaire complet - KPI elegant en anneau pour tableaux de bord.
Arc de 270 degres - plus de longueur pour une lecture plus fine qu un demi-cercle.
Sans aiguille ni ticks - valeur en grand sur un arc colore epure.
Demi-arc avec graduations regle tous les 5% et labels majeurs tous les 25%.
Style batterie / barre de reseau avec segments discrets s allumant par seuil.
Effet neon sur l arc actif - look dashboard sombre tres marquant.
Deux arcs concentriques : externe = courant, interne = comparaison ou cible.