numeraire_graphics.plot_cumulative

numeraire_graphics.plot_cumulative(results: DataFrame, *, benchmark: str | Series | None = None, recessions: Any = None) → plotnine.ggplot

Cumulative-return and drawdown curves from per-date strategy-return rows.

Consumes the metric == "strategy_return" rows (one per date per method, as emitted by StrategyReturnEvaluator): each method’s returns are geometrically compounded into a wealth curve and its drawdown, shown in stacked facets (geom_line coloured by method, a zero reference line).

benchmark overlays a reference as a distinct dashed line: pass a method name already in results (it is drawn as the benchmark rather than a peer) or a date-indexed pd.Series of returns supplied by the caller. recessions shades caller-supplied (start, end) date spans via geom_rect — the caller provides the dates; nothing is fetched.