feat(cpp/datascience): CPU stats + MCMC primitives
Nuevo dominio cpp/functions/datascience con primitivas puras CPU para post- proceso de samples Monte Carlo y diagnostico de cadenas MCMC. Diseñadas como gemelas CPU de los kernels GPU (rng pareja con gpu_rng_glsl, MH 1D/ND con mc_metropolis_hastings_gpu) para validar numericamente y para datasets pequeños donde el dispatch GPU no compensa. - rng: xoshiro256++ con uniform / normal (Box-Muller) / below (Lemire) / categorical. Determinista bit-exacto dado seed. - stats_summary: sum (Kahan), mean, var/std (Welford one-pass), min, max, quantile / percentile (R type-7). - autocorr: r(k), ACF, tau_int (Sokal) — diagnostico ACF y ESS. - rhat_ess: Gelman-Rubin clasico y split + ESS basico (multi-chain). - beta_dist: lgamma (Lanczos), beta_pdf, beta_cdf (continued fraction), beta_quantile, mean/var/std — para inferencia Beta-Binomial. - drawdown: max_dd absoluto/pct + underwater series para sesiones simuladas y backtests. - samples_to_grid_2d: binning 2D CPU para alimentar heatmap_cpp_viz / contour_cpp_viz desde samples (x[], y[]). - metropolis_hastings: MH 1D y ND con target log-pdf como std::function (no normalizada). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,23 @@
|
||||
#pragma once
|
||||
|
||||
#include <cstddef>
|
||||
|
||||
namespace fn::ds {
|
||||
|
||||
struct DrawdownResult {
|
||||
double max_dd = 0.0; // peak - trough
|
||||
double max_dd_pct = 0.0; // (peak - trough) / peak (si peak > 0)
|
||||
std::size_t peak_idx = 0; // indice donde ocurre el peak antes del trough
|
||||
std::size_t trough_idx = 0; // indice del trough que crea el max_dd
|
||||
};
|
||||
|
||||
// Calcula el max drawdown sobre una serie de balance/equity. Recorrido
|
||||
// O(n). Equity[i] puede ser negativo (no valid para max_dd_pct, que se
|
||||
// devuelve 0 si peak <= 0).
|
||||
DrawdownResult drawdown_max(const double* equity, std::size_t n);
|
||||
|
||||
// Llena out[n] con el drawdown actual en cada punto: out[i] = peak_so_far - equity[i].
|
||||
// Util para plotear underwater chart.
|
||||
void drawdown_series(const double* equity, std::size_t n, double* out);
|
||||
|
||||
} // namespace fn::ds
|
||||
Reference in New Issue
Block a user