Bullet - Compact KPI vs Target
Signature
sp.bullet(title, labels, values, *, targets=None, max_vals=None, ranges=None, comparisons=None, variant="basic", **kwargs) -> Chart
Description
sp.bullet() is the unified entry point for the bullet-chart family. Inspired by Edward Tufte, a bullet packs an actual value, a target, qualitative ranges and a scale into a single horizontal row - perfect for KPI dashboards where space is precious. The variant keyword switches the visual treatment (zones, traffic light, thermometer, progress pill, dot, ghost-bar comparison) without touching the data.
Variants
Parameters
Returns
Chart - object with .html property and .show() method.
Classic Tufte bullet: track + qualitative range + value bar + target tick.
Three graduated qualitative bands (poor / satisfactory / good) drawn behind the value bar.
Vertical thermometer style with a bulb base - dramatic for KPIs in a row.
Traffic-light segmented track (red / amber / green) for status dashboards.
Sparkline-thin pill bar with target tick only - ultra-clean inline indicator.
Single dot on a track instead of a bar - dot-plot variant of the bullet.
Pill-shape gradient progress bar with a percentage label centered inside.
Adds a ghost bar (e.g. previous period via comparisons) behind the current value.
Signature
sp.bullet(title, labels, values, *, targets=None, max_vals=None, ranges=None, comparisons=None, variant="basic", **kwargs) -> Chart
Description
sp.bullet() est le point d entree unique pour la famille bullet. Inspire par Edward Tufte, le bullet condense valeur, cible, zones qualitatives et echelle dans une seule ligne horizontale - parfait pour des dashboards KPIs serres. Le mot-cle variant change l aspect (zones, feu tricolore, thermometre, pillule de progression, point, comparaison par barre fantome) sans toucher aux donnees.
Variantes
Paramètres
Retour
Chart - objet avec propriete .html et methode .show().
Bullet de Tufte classique : piste + zone qualitative + barre de valeur + tick de cible.
Trois bandes qualitatives graduees (faible / correct / bon) derriere la barre de valeur.
Style thermometre vertical avec bulbe - tres parlant pour des KPIs alignes.
Piste segmentee feu tricolore (rouge / orange / vert) pour tableaux de bord.
Barre pillule fine type sparkline avec uniquement le tick cible - indicateur inline epure.
Un seul point sur la piste au lieu d une barre - variante dot-plot du bullet.
Barre de progression pillule en degrade avec pourcentage centre.
Ajoute une barre fantome (par ex. periode precedente via comparisons) derriere la valeur courante.