clvkit.plotting.plot_clv

plot_clv(result, *, ax=None, ax_kwargs=None, scatter_kwargs=None, curve_levels=4, levels=None, cmap='viridis', colorbar=True, vmin=None, vmax=None, title=None, currency='$')

Show how discounted transactions and spend make up each CLV.

The dashed lines are equal-CLV curves, drawn at round money levels so a reader traces “everyone on this line is worth about the same” rather than decoding a percentile. currency is the symbol on the axes and labels; it does not convert anything — the numbers are whatever unit expected_spend already carries.

Every knob is optional and falls back to a sensible default when left as None:

• levels — the CLV values the curves sit at. Default: curve_levels round money levels spread across the bulk of the distribution.

• vmin / vmax — the colour scale. Default: 0 and the 95th percentile of CLV, so a handful of whales don’t wash the ramp out.

Marker styling (size, alpha, edge colour, …) goes through scatter_kwargs rather than loose **kwargs, so the signature stays fully typed.

Parameters:

• result (CLVResult)

• ax (Axes | None)

• ax_kwargs (dict | None)

• scatter_kwargs (dict | None)

• curve_levels (int)

• levels (list[float] | None)

• cmap (str)

• colorbar (bool)

• vmin (float | None)

• vmax (float | None)

• title (str | None)

• currency (str)

Return type:

Axes