Waterfall — Running-Total Bridge Chart
Signature
sp.waterfall(title, labels, values, *, variant="basic", show_text=True, **kwargs) -> Chart
Description
sp.waterfall() renders the entire waterfall-chart family: a sequence of bars where each step adds (positive) or subtracts (negative) from a running total. The variant keyword selects the geometry without touching any other parameter. Waterfalls are the standard for P&L bridges, variance analysis, cohort decomposition, fee/tax breakdowns and any "from A to B, what changed?" narrative.
Totals — set a value to
0and use a label containingtotal,net,final,grossorebitdato mark a subtotal bar; it is rendered with the totals color and anchored on the running sum.
Variants
Parameters
Returns
Chart — object with .html property and .show() method.
Classic running-sum bars with dashed connectors between consecutive steps.
Bars touch each other forming a continuous staircase, no connectors needed.
Stick + circle marker at the end of each step. Excellent ink-to-data ratio.
Triangle on top (positives) or bottom (negatives) emphasizes direction at a glance.
Bars + signed percentage badge (Delta vs previous running total) above each step.
Rotated 90 degrees: each step becomes a horizontal row stacking downward, anchored to the previous running total. Editorial layout for reports with long labels or vertical storytelling.
Signature
sp.waterfall(title, labels, values, *, variant="basic", show_text=True, **kwargs) -> Chart
Description
sp.waterfall() rassemble toute la famille des graphiques waterfall : une suite de barres ou chaque etape ajoute (positif) ou retranche (negatif) au cumul courant. Le mot-cle variant change la geometrie sans toucher aux autres parametres. Les waterfalls sont la reference pour les ponts de P&L, l analyse d ecarts, la decomposition de cohortes, le detail des frais/taxes et tout recit du type "de A vers B, qu est-ce qui a change ?".
Totaux — mettez la valeur a
0et utilisez un libelle contenanttotal,net,final,grossouebitdapour marquer une barre de sous-total ; elle est rendue avec la couleur des totaux et ancree sur le cumul courant.
Variantes
Paramètres
Retour
Chart — objet avec une propriete .html et une methode .show().
Barres classiques a somme cumulee avec connecteurs pointilles entre etapes.
Barres jointives formant un escalier continu, sans connecteur.
Tige + cercle en fin de chaque etape. Excellent ratio encre/donnee.
Triangle dessus (positifs) ou dessous (negatifs) pour souligner la direction en un coup d oeil.
Barres + badge de pourcentage signe (Delta vs cumul precedent) au-dessus de chaque etape.
Waterfall pivote a 90 degres : les etapes deviennent des lignes empilees verticalement, chacune partant du cumul precedent. Layout editorial pour rapports avec libelles longs ou storytelling vertical.