Scelo Bridge & exports¶

Offline by default¶

Scelo Atlas makes no network calls unless the Scelo Bridge is explicitly enabled. Every result is available locally: the metrics delegates feed any UMG widget, and the full results pack exports to CSV/JSON on disk.

The export pack¶

Scelo.Export <All|Metrics|ELT|YLT|PLT|EPT|Locations|Footprints|Detail|OED|ModelCard|Zip|Verify> [dir=] [topn=] [years=40000] [seed=20260623] [zip=1]

Works in any level — with no placed city or cyclone it falls back to the bundled sample book (DA_Ekhaya2, Ekhaya Cove). The Output Log prints where every file landed.

Scelo.Export All writes the complete actuarial results pack — summary_metrics.json (AAL ± SE, annual σ, TVaR ladder, OEP/AEP by return period, in GU / Gross / Net perspectives, plus convergence diagnostics), ept.csv with confidence bands, year-/event-/period-loss tables, per-location detail, loss attribution, per-event hazard footprints and a manifest with run id and seed. Zip bundles it; Verify re-checks it. The Data formats page documents every file.

The pack is designed for independent validation: the reference validator recomputes every number from the raw tables — 108/108 checks pass against engine output.

In code, USceloBridgeSubsystem::ExportMetricsToFile(Metrics, ScenarioName, …) writes the same JSON from Blueprint or C++.

Configuring the Bridge (optional)¶

Edit → Project Settings → Game → Scelo Atlas (section "Scelo Bridge"): set the endpoint and the API key issued by Intelligent Actuaries, then enable the bridge. Each simulation run is handed off over HTTPS to the Scelo platform's climate and capital agents, and the AI-written executive brief returns into the engine (the demo panel's brief view; RequestExecutiveBrief in code).

Without an endpoint the plugin behaves identically except nothing leaves the machine — hand the exported pack to Scelo manually instead.

Programmatic surface¶

USceloSimulationSubsystem — RunMonteCarlo(Years), progress + completion delegates, FSceloPortfolioMetrics results struct
USceloPortfolioAsset — LoadLocationsFromCSV, LoadVulnCurvesFromCSV, geo-projection settings (OriginLatitude/Longitude, UnitsPerMetre, WorldScaleDivisor)
USceloMetricsWidget — reparent a UMG widget to it and bind OnLiveLoss / OnMetricsUpdated; FormatMoneyCompact for display
ASceloExposureVisualizer — assign a portfolio asset, click Rebuild Instances, get the TIV-column skyline
ASceloCycloneActor — StormParams (ΔP hPa, Rmax km, Holland B, heading, forward speed, origin lat/lon), StartStorm, re-parameterize live via Scelo.SetStorm

Version¶

This documentation describes Scelo Atlas v0.2.1 on Unreal Engine 5.8 (v0.2.1 is a documentation-only release over v0.2.0 — no code changes). Changelog highlights vs v0.1: tornado and tsunami directors, recorded strong-motion earthquake playback, the Scelo Lab arena, SceloClimate Studio, the one-command cinematic director, built-in Niagara weather FX and water-interaction content, ground-up vs insured split through the ELT and live overlays, and the declared Water plugin dependency.