========= Reference ========= The contracts, layer by layer: what a compiled dataset is, what the simulator guarantees, how the optimizer prices a schedule, and the rules that make a schedule spatially real. These pages are the authority on mechanism; the how-to guides are the authority on tasks, and the guides on symptoms. .. list-table:: :header-rows: 1 :widths: 26 74 * - Page - What it specifies * - :doc:`compiled-dataset` - The runtime contract: the tables, the manifest, and the invariants that hold across them. * - :doc:`forestmodelxml` - The recipe format WS4 reads, the matrix it compiles, and the known gaps. * - :doc:`simulator` - The annual step, the schedule, and every file a run writes. * - :doc:`report-provenance` - The report sidecar: file digests, source metadata, run and dataset identifiers, and explicit uncertainty. * - :doc:`prices` - The read-only ``prices.v1`` scenario price-path table, its named paths, the base-relative comparison, and the ``not a forecast`` caveat. * - :doc:`optimizer` - Targets and the objective, the operator registry, the metaheuristics, and the MIP bound. * - :doc:`spatial` - Block topology, patch metrics and size classes, edge contrast, and the opening rules. * - :doc:`roads` - The network tables, least-cost routing, and the route accounts. * - :doc:`carbon` - The FEMIC package contract, SIT compile, libcbm runtime, optimizer ledger, fertilization, HWP lifecycle and system accounts, carbon yield curves, and the GCBM bridge boundary. * - :doc:`dhi` - Dynamic Habitat Index ingest, account semantics, provenance, and web layer. * - :doc:`structure-habitat` - The published Coops et al. structure index, required metrics, accounts, and gaps. * - :doc:`resilience` - Connectivity, age-class diversity, and fragmentation accounts from existing state. * - :doc:`species-composition` - Dominant-species ingest, block fractions, and VRI comparison. * - :doc:`recovery` - Post-fire spectral recovery ingest, block status, and caveats. * - :doc:`sdmd` - The stand density management contracts, the AU Explorer boundary, and the validation codes. * - :doc:`forest-condition` - The report-only forest-condition card schema, advisory alerts, and limits. * - :doc:`storyboard` - The one-page run storyboard that reuses the condition card. * - :doc:`performance` - The measured figures and how to reproduce them. * - :doc:`web` - The optional HTTP service over a run's artefacts, and the browser front end's contract. * - :doc:`femic-lidar` - Pinned FEMIC LidarBC bundles, checksums, and polygon support summaries. * - :doc:`disturbance` - Read-only ``femic.disturbance.v1`` events and the summary report. * - :doc:`event-log` - The unified event record, deterministic ordering, counter-based random tape, and replay contract. * - :doc:`ecosystem-package` - The optional state schema, cohort fractions, null bridge, and dataset join. * - :doc:`ecosystem-process` - The generic annual executor, process protocol, ownership, ordering, and fire migration. * - :doc:`ecosystem-succession` - Succession, regeneration, and the provisional biomass-to-volume bridge. * - :doc:`risk-optimization` - Scenario account overlays and risk-aggregated targets in the estate optimizer. * - :doc:`ecosystem-ensemble` - Process-driven fire/succession/regeneration scenario ensembles. * - :doc:`ecosystem-management` - Schedule-to-cohort harvest bridge for process-conditioned landscapes. * - :doc:`ecosystem-evaluation` - Process-conditioned evaluation of a block-level harvest schedule. * - :doc:`ecosystem-dataset` - Load a compiled dataset into the process engine and run a schedule. * - :doc:`process-search` - Deterministic candidate ranking over process-conditioned schedules. * - :doc:`schedule-grammar` - Deterministic add/remove and optional offset moves for process schedule candidates. * - :doc:`process-optimization` - End-to-end grammar plus hill-climb process optimization and artifacts. * - :doc:`ecosystem-landis` - LANDIS-II-compatible succession kernel and exact reference tests. * - :doc:`fire-regime` - scfm fire-regime parameters and distributional diagnostics. * - :doc:`fire-risk` - Annual fire-regime risk summaries over process event logs. * - :doc:`ecosystem-fire` - The first stochastic process: Poisson ignition, graph spread, mortality, salvage, and disturbance accounts. * - :doc:`ecosystem-scenarios` - Scenario ensembles, common random numbers, risk targets, and the out-of-sample report. * - :doc:`fire-behaviour` - The Rothermel surface-fire kernel, fuel and moisture contracts, standard cases, and derived intensity. * - :doc:`fire-weather` - The Canadian FWI moisture codes, the daily weather contract, and the reference validation. * - :doc:`fire-fbp` - The FBP fuel types, surface fuel consumption, surface rate of spread, and surface intensity. * - :doc:`fire-crown` - Crown fire initiation, the FBP crown fraction, the C6 crown rate of spread, and the active-crown threshold. * - :doc:`fire-growth` - The site grid, slope-adjusted effective wind, Huygens growth, and perimeter snapshots. * - :doc:`fire-vri` - The VRI stand contract, the deterministic FBP fuel-type rules, and provenance. * - :doc:`fire-benchmark` - The FBP ellipse benchmark, the scenario ensemble, and the reported tolerances. * - :doc:`fire-observed` - The observed-fire contract and the Dogrib validation fixture. * - :doc:`fire-corpus` - The tiered public fire corpus, admission gate, and candidate inventory. * - :doc:`fire-reanalysis-case` - One CFSDS event with hourly reanalysis weather and its uncalibrated overprediction result. * - :doc:`fire-containment` - Containment masks and the free-burn versus suppressed validation protocol. * - :doc:`fire-treatment-evidence` - Published fuel-treatment effect ranges and the deferred validation gate. * - :doc:`fire-treatment-effects` - Measured pre/post canopy, basal-area, and surface-fuel changes from open FFS data. * - :doc:`fire-treatment-prescription` - Explicit VRI stand treatment inputs and before/after FBP assignments. * - :doc:`fire-canopy-scenario` - Controlled open-VRI canopy-only treatment scenario and its negative C2 result. * - :doc:`fire-tree-mortality` - FOFEM crown-scorch mortality and validation against the public FTM database. * - :doc:`decision-quality` - Expected outcome, regret, robustness, and rank stability across uncertain scenarios. * - :doc:`fire-wind` - WindNinja angle and velocity pairs, direction selection, and provenance. * - :doc:`fire-scene` - Synthetic individual-tree stands, the portable fire-scene package, and the standalone 3D fire viewer. * - :doc:`femic-hydrology` - Pinned FEMIC hydrology response bundles, checksums, flood-risk rows, and applicability metadata. .. toctree:: :maxdepth: 2 :hidden: compiled-dataset forestmodelxml simulator report-provenance prices optimizer spatial roads carbon dhi structure-habitat resilience species-composition recovery forest-condition storyboard performance sdmd web femic-lidar disturbance event-log ecosystem-package ecosystem-process ecosystem-succession risk-optimization ecosystem-ensemble ecosystem-management ecosystem-evaluation ecosystem-dataset process-search schedule-grammar process-optimization ecosystem-landis fire-regime fire-risk ecosystem-fire ecosystem-scenarios fire-behaviour fire-weather fire-fbp fire-crown fire-growth fire-vri fire-benchmark fire-observed fire-corpus fire-reanalysis-case fire-containment fire-treatment-evidence fire-treatment-effects fire-treatment-prescription fire-canopy-scenario fire-tree-mortality decision-quality fire-wind fire-scene femic-hydrology