Methodology

How we know what we know.

Meridian's pipeline is documented end-to-end. There are no black boxes between an observation in the world and a number on a Meridian dashboard.

  1. 01

    Ingest

    Telemetry, market feeds, satellite imagery, and operator filings stream into a partitioned lakehouse with full provenance metadata.

  2. 02

    Validate

    Each signal is cross-checked against ≥2 independent sources. Conflicts are surfaced, never silently averaged.

  3. 03

    Reconcile

    Bayesian state estimators reconcile partial telemetry with physical constraints and historical priors.

  4. 04

    Attribute

    Every published metric carries an attribution graph: source, transform, model version, and confidence interval.

  5. 05

    Publish

    Outputs are versioned and immutable. Corrections issue as new versions; nothing is rewritten in place.

  6. 06

    Audit

    External auditors are granted read-only access to the full pipeline. Audit reports are public.

Confidence

Every Meridian figure is published with a 95% confidence interval and a method version string. If you can read the number, you can audit how we got there.

Index · v1.0.0

energy pulse

Real-time composite of grid stress and resilience. Computed per region or globally.

EnergyPulse = 100 × ( 0.20·D' + 0.20·R + 0.15·M + 0.20·C' + 0.10·X' + 0.15·V' )

Inputs

InputUnitRangeDirectionWeightDefinition
Demandload / capacity01.1↓ better20.0%Instantaneous load divided by available capacity.
Reliabilityscore 0..101↑ better20.0%1 − (frequency deviation + outage minutes) normalized.
Reserve Marginfraction00.4↑ better15.0%(Capacity − Peak Demand) / Peak Demand.
Carbon IntensitygCO₂/kWh20900↓ better20.0%Generation-weighted grid carbon intensity.
Congestionutilization01↓ better10.0%Mean transmission line utilization.
Pricing Volatilityσ/μ (24h)01↓ better15.0%Coefficient of variation of wholesale price over 24 hours.

Confidence

Gaussian propagation of per-input (1 − confidence) variance; 95% CI = ±1.96·σ.

Index · v1.0.0

global energy index

Country-level composite of structural energy-system performance across six pillars.

GEI = 100 × Σ wi · pillar_i ; default wi = 1/6 each

Inputs

InputUnitRangeDirectionWeightDefinition
Reliabilityscore 0..101↑ better16.7%SAIDI/SAIFI proxy + frequency stability.
Affordabilityprice / GDPpc00.15↓ better16.7%Retail price per kWh as fraction of GDP per-capita-hour.
Sustainabilityrenewable share01↑ better16.7%Low-carbon generation share weighted against carbon intensity.
CapacityMW/capita00.004↑ better16.7%Installed generating capacity per capita.
Infrastructure Healthscore 0..101↑ better16.7%Asset age, investment trend, transmission coverage.
Energy Securityscore 0..101↑ better16.7%Import dependency + fuel-mix diversity (Shannon entropy).

Confidence

Gaussian propagation of per-pillar (1 − confidence) variance; 95% CI = ±1.96·σ.

Public API

Programmatic access

Every published methodology and every historical calculation is queryable without authentication.

GET/api/public/methodology

List every registered methodology version.

GET/api/public/methodology?index=energy_pulse

Filter to a single index.

GET/api/public/energy-pulse

Latest global Energy Pulse with 95% CI.

GET/api/public/energy-pulse?history=1

Latest + last 100 historical snapshots.

GET/api/public/global-energy-index?country=DE

Latest GEI for a country (ISO code).

GET/api/public/global-energy-index?country=DE&history=1

Historical GEI series.

GET/api/public/forecast?metric=demand_mw&scope=US

Latest demand forecasts (Holt-Winters, Prophet, XGBoost, LightGBM) with 80/95% intervals + scorecards.

POST/api/public/forecast?metric=demand_mw&scope=US

Retrain & backtest all four model families (requires INGEST_API_KEY).

Forecasting Engine · v1.0.0

Four-model ensemble, scored

The MVP rule-based stress engine has been replaced by a four-family ML stack. Every retrain runs all four in parallel, ranks them by backtest sMAPE, and writes per-fold predictions, residuals and confidence intervals to the historical archive.

Holt-Winters Additive

Triple exponential smoothing with daily seasonality. Best for stable, strongly seasonal demand.

Prophet-Additive

Linear trend + Fourier seasonality (daily/weekly/yearly). Robust to gaps and changepoints.

XGBoost (depth-wise)

Gradient boosted trees on 24 lag features + cyclical encodings. Captures non-linear effects.

LightGBM (leaf-wise)

Leaf-wise tree growth, deeper interactions. Often wins on long horizons.

Pipeline

  1. Train — fit each model on the full observation series; record sMAPE, RMSE, MAE, R² in forecast_runs.
  2. Predict — emit point forecasts with 80% and 95% gaussian prediction intervals derived from training residual σ.
  3. Backtest — rolling-origin cross-validation with k folds and fixed horizon; per-fold scorecards stored in forecast_backtests.
  4. Grade — aggregate sMAPE → A (<5%), B (<10%), C (<20%), D (<35%), F otherwise. Best family per metric/scope flagged automatically.
  5. Backfill — once truth lands, actual, abs_error, ape are written on each historical prediction for live MAPE tracking.