Ridgeline — Joyplot / Stacked KDE
Signature
sp.ridgeline(title, categories, values, *, variant="basic", overlap=0.5, bandwidth=0.0, n_points=60, fill_opacity=56, palette=None, priority=None, **kwargs) -> Chart
Description
sp.ridgeline() is the unified entry point for the entire ridgeline family — also known as joyplot. The variant keyword selects the rendering strategy — every other argument keeps the same name across variants. A ridgeline plot stacks one KDE curve per category along a shared X axis with a controllable vertical overlap, making it ideal to compare distributions across many groups (years, regions, segments…). SeraPlot renders everything in pure Rust SVG, with quartile/mean overlays, rug ticks, gradient fills and a built-in viridis colormap. priority takes a list of row indices (in their displayed order) to draw last, on top of every other ridge - use it to force a specific distribution to visually climb over its neighbors regardless of its position in the stack.
Variants
Parameters
Returns
Chart — object with .html property and .show() method.
Stacked filled ridges (one per category) with white underlay.
Stroke-only ridges, no fill — clean outline view.
Marks Q1, median (solid), and Q3 vertical lines on each ridge.
Dashed line + dot at the mean of each distribution.
Filled ridge with rug ticks below the baseline at sample positions.
Auto viridis palette across ridges (or custom palette).
Forced low overlap — ridges are separated for clarity.
Signature
sp.ridgeline(title, categories, values, *, variant="basic", overlap=0.5, bandwidth=0.0, n_points=60, fill_opacity=56, palette=None, priority=None, **kwargs) -> Chart
Description
sp.ridgeline() est le point d'entrée unifié pour toute la famille ridgeline — aussi appelé joyplot. Le mot-clé variant sélectionne la stratégie de rendu — tous les autres arguments conservent le même nom d'une variante à l'autre. Un ridgeline empile une courbe KDE par catégorie sur un axe X partagé avec un recouvrement vertical réglable, idéal pour comparer des distributions à travers plusieurs groupes (années, régions, segments…). SeraPlot rend tout en SVG Rust natif, avec marqueurs quartiles/moyenne, ticks rug, dégradés et palette viridis intégrée. priority prend une liste d'index de lignes (dans leur ordre affiché) à dessiner en dernier, par-dessus toutes les autres crêtes - utile pour forcer une distribution donnée à visuellement monter sur ses voisines quelle que soit sa position dans l'empilement.
Variantes
Paramètres
Retour
Chart — objet avec propriété .html et méthode .show().
Crêtes empilées remplies (une par catégorie) avec fond blanc.
Crêtes en trait seul, sans remplissage — vue épurée.
Trace les verticales Q1, médiane (pleine) et Q3 sur chaque crête.
Trait pointillé + point à la moyenne de chaque distribution.
Crête remplie avec ticks rug sous la ligne de base aux positions des points.
Palette viridis automatique sur les crêtes (ou palette personnalisée).
Recouvrement forcé bas — crêtes séparées pour la lisibilité.