Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

KDE — Kernel Density Estimate

Signature

sp.kde(title, values=None, *, x=None, y=None, variant="basic", categories=None, bandwidth=0.0, filled=True, fill_opacity=50, bins=30, n_points=80, palette=None, **kwargs) -> Chart

Description

sp.kde() is the unified entry point for the entire Kernel Density Estimate family. The variant keyword selects the rendering strategy — every other argument keeps the same name across variants. KDE produces a smooth, continuous density estimate from a sample of points using a Gaussian kernel with Scott's rule for automatic bandwidth selection. SeraPlot renders the curves as pure Rust SVG, with native multi-series, normalization, CDF, rug, histogram overlay and gradient fills.

Variants

Parameters


Returns

Chart — object with .html property and .show() method.


Variant "basic"Aliases basic / filled / default / single / multiReturns Chart

Filled curve, single or multi-series.

Preview
Variant "outline"Aliases outline / line / stroke / compare / no_fillReturns Chart

Stroke-only curves for clean overlays.

Preview
Variant "stepped"Aliases stepped / step / stair / stairsReturns Chart

Stair-stepped density (rectangular look).

Preview
Variant "rug"Aliases rug / carpet / ticks / rugplotReturns Chart

KDE curve with rug ticks at sample positions.

Preview
Variant "histogram"Aliases histogram / hist / with_hist / kdehist / distplotReturns Chart

KDE curve overlaid on a normalized histogram.

Preview
Variant "normalized"Aliases normalized / pdf / norm / densityReturns Chart

Each series normalized so its area integrates to 1.

Preview
Variant "cumulative"Aliases cumulative / cdf / cumReturns Chart

Cumulative density (CDF) curve in [0, 1].

Preview
Variant "contour"Aliases contour / bivariate / kde2d / joint_density / smoothRequired x, yOptional categoriesReturns Chart

Bivariate (2D) kernel density estimate — a product-kernel Gaussian evaluated on a grid and rendered as a shaded density surface with the raw points overlaid. Pass categories to overlay one density surface per group, each in its own color with a legend.

Preview
Variant "levels"Aliases levels / bands / iso_bands / ring_contour / bandedRequired x, yOptional categoriesReturns Chart

Bivariate KDE quantized into discrete iso-density bands with a visible ring border at each band boundary — matches seaborn's kdeplot(x=, y=, hue=, fill=True) stepped-level look, as opposed to contour's continuous gradient.

Preview
Variant "stack"Aliases stack / stacked / layered_stackReturns Chart

Each group's density curve stacked on top of the previous one's (cumulative running total), all evaluated on one shared x-grid - matches seaborn's kdeplot(hue=, multiple="stack").

Preview
Variant "fill"Aliases fill / stack100 / percent_stack / filled_stackReturns Chart

100%-stacked density - at every x position the groups sum to 100%, showing the changing share of the total instead of absolute density - matches seaborn's kdeplot(hue=, multiple="fill").

Preview

Signature

sp.kde(title, values=None, *, x=None, y=None, variant="basic", categories=None, bandwidth=0.0, filled=True, fill_opacity=50, bins=30, n_points=80, palette=None, **kwargs) -> Chart

Description

sp.kde() est le point d'entrée unifié pour toute la famille KDE (Kernel Density Estimate). 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. La KDE produit une estimation de densité continue lissée à partir d'un échantillon de points avec un noyau gaussien et la règle de Scott pour le choix automatique de la bande passante. SeraPlot rend les courbes en SVG Rust natif, avec multi-séries, normalisation, CDF, rug, histogramme superposé et remplissage en dégradé.

Variantes

Paramètres


Retour

Chart — objet avec propriété .html et méthode .show().


Variante "basic"Alias basic / filled / default / single / multiRetour Chart

Courbe pleine, mono ou multi-séries.

Aperçu
Variante "outline"Alias outline / line / stroke / compare / no_fillRetour Chart

Courbes en trait seul pour des superpositions épurées.

Aperçu
Variante "stepped"Alias stepped / step / stair / stairsRetour Chart

Densité en escalier (rendu rectangulaire).

Aperçu
Variante "rug"Alias rug / carpet / ticks / rugplotRetour Chart

Courbe KDE avec ticks rug aux positions des points.

Aperçu
Variante "histogram"Alias histogram / hist / with_hist / kdehist / distplotRetour Chart

Courbe KDE par-dessus un histogramme normalisé.

Aperçu
Variante "normalized"Alias normalized / pdf / norm / densityRetour Chart

Chaque série normalisée pour que son aire vaille 1.

Aperçu
Variante "cumulative"Alias cumulative / cdf / cumRetour Chart

Densité cumulée (CDF) dans [0, 1].

Aperçu
Variante "contour"Alias contour / bivariate / kde2d / joint_density / smoothRequis x, yOptionnel categoriesRetour Chart

Estimation de densité bivariée (2D) — un noyau gaussien produit évalué sur une grille et rendu comme une surface de densité ombrée, avec les points bruts superposés. Passez categories pour superposer une surface de densité par groupe, chacune dans sa propre couleur avec une légende.

Aperçu
Variante "levels"Alias levels / bands / iso_bands / ring_contour / bandedRequis x, yOptionnel categoriesRetour Chart

KDE bivariée quantifiée en bandes iso-densité discrètes avec une bordure visible à chaque frontière de bande — reproduit le rendu par niveaux de kdeplot(x=, y=, hue=, fill=True) de seaborn, par opposition au dégradé continu de contour.

Aperçu
Variante "stack"Alias stack / stacked / layered_stackRetour Chart

La courbe de densité de chaque groupe est empilée sur celle du précédent (total cumulé), toutes évaluées sur une même grille x partagée - reproduit kdeplot(hue=, multiple="stack") de seaborn.

Aperçu
Variante "fill"Alias fill / stack100 / percent_stack / filled_stackRetour Chart

Densité empilée à 100% - à chaque position x, les groupes totalisent 100%, montrant la part changeante du total plutôt que la densité absolue - reproduit kdeplot(hue=, multiple="fill") de seaborn.

Aperçu