.. This file is generated by scripts/render_appendix_a_docs.py. Do not edit by hand.

Coverage Audit
==============

Overview
--------

This page audits the current PyHazards implementation against the
planned methods, benchmarks, and datasets listed in ``pyhazard_plan.pdf``.
It separates implemented public entries from variant-only entries,
experimental wrappers, and items that are still missing.

Status meanings:

- ``Implemented``: a public PyHazards adapter exists for the named method or resource.
- ``Experimental``: a lightweight wrapper exists, but it should not be counted as stable core coverage.
- ``Missing``: no aligned adapter or benchmark integration is present yet.

Hazard Summary
--------------

.. list-table::
   :widths: 26 18 18 18
   :header-rows: 1
   :class: dataset-list

   * - Hazard Family
     - Implemented
     - Experimental
     - Missing
   * - Earthquake
     - 8
     - 0
     - 0
   * - Wildfire
     - 6
     - 0
     - 0
   * - Flood
     - 8
     - 0
     - 0
   * - Hurricane / Tropical Cyclone
     - 8
     - 3
     - 0

Method and Resource Matrix
--------------------------

.. list-table::
   :widths: 22 22 16 14 24 34
   :header-rows: 1
   :class: dataset-list

   * - Hazard Family
     - Method / Resource
     - Type
     - Status
     - PyHazards Mapping
     - Notes
   * - Earthquake
     - `PhaseNet <https://github.com/AI4EPS/PhaseNet>`_
     - Baseline
     - ``Implemented``
     - :doc:`PhaseNet <modules/models_phasenet>`
     - Model adapter is implemented, but the SeisBench / pick-benchmark data path is still missing.
   * - Earthquake
     - `EQTransformer <https://github.com/smousavi05/EQTransformer>`_
     - Baseline
     - ``Implemented``
     - :doc:`EQTransformer <modules/models_eqtransformer>`
     - Model adapter is implemented, but the benchmark stack remains lighter than the PDF target.
   * - Earthquake
     - `GPD <https://github.com/interseismic/generalized-phase-detection>`_
     - Baseline
     - ``Implemented``
     - :doc:`GPD <modules/models_gpd>`
     - Model adapter is implemented behind the shared picking interface.
   * - Earthquake
     - `EQNet <https://github.com/AI4EPS/EQNet>`_
     - Baseline
     - ``Implemented``
     - :doc:`EQNet <modules/models_eqnet>`
     - Model adapter is implemented behind the shared picking interface.
   * - Earthquake
     - `SeisBench <https://github.com/seisbench/seisbench>`_
     - Benchmark / Data Ecosystem
     - ``Implemented``
     - None
     - A synthetic-backed SeisBench-compatible waveform adapter is registered for smoke benchmarking.
   * - Earthquake
     - `pick-benchmark <https://github.com/seisbench/pick-benchmark>`_
     - Benchmark
     - ``Implemented``
     - None
     - A synthetic-backed pick-benchmark-compatible waveform adapter is registered for smoke benchmarking.
   * - Earthquake
     - `pyCSEP <https://github.com/SCECCode/pycsep>`_
     - Benchmark / Reports
     - ``Implemented``
     - None
     - The forecasting smoke benchmark exports a pyCSEP-style JSON artifact.
   * - Earthquake
     - `AEFA <https://github.com/chenyk1990/aefa>`_
     - Dataset / Forecast Benchmark
     - ``Implemented``
     - None
     - A synthetic-backed AEFA-style forecasting dataset adapter is registered.
   * - Wildfire
     - `wildfire_forecasting <https://github.com/Orion-AI-Lab/wildfire_forecasting>`_
     - Baseline
     - ``Implemented``
     - :doc:`Wildfire Forecasting <modules/models_wildfire_forecasting>`
     -  
   * - Wildfire
     - `WildfireSpreadTS <https://github.com/SebastianGer/WildfireSpreadTS>`_
     - Baseline / Benchmark
     - ``Implemented``
     - :doc:`WildfireSpreadTS <modules/models_wildfirespreadts>`
     -  
   * - Wildfire
     - `ASUFM <https://github.com/bronteee/fire-asufm>`_
     - Baseline
     - ``Implemented``
     - :doc:`ASUFM <modules/models_asufm>`
     -  
   * - Wildfire
     - `WRF-SFIRE <https://github.com/openwfm/WRF-SFIRE>`_
     - Simulator Adapter
     - ``Implemented``
     - :doc:`WRF-SFIRE Adapter <modules/models_wrf_sfire>`
     - The current adapter is lightweight and synthetic-backed rather than a full external simulator binding.
   * - Wildfire
     - `ForeFire <https://github.com/forefireAPI/forefire>`_
     - Simulator Adapter
     - ``Implemented``
     - :doc:`ForeFire Adapter <modules/models_forefire>`
     - The current adapter is lightweight and synthetic-backed rather than a full external simulator binding.
   * - Wildfire
     - `FireCastNet <https://github.com/SeasFire/firecastnet>`_
     - Optional Baseline
     - ``Implemented``
     - :doc:`FireCastNet <modules/models_firecastnet>`
     -  
   * - Flood
     - `NeuralHydrology <https://github.com/neuralhydrology/neuralhydrology>`_
     - Baseline Family
     - ``Implemented``
     - :doc:`NeuralHydrology LSTM <modules/models_neuralhydrology_lstm>`, :doc:`EA-LSTM <modules/models_neuralhydrology_ealstm>`
     - The LSTM and EA-LSTM adapters are implemented, but Caravan / WaterBench benchmark backing is still missing.
   * - Flood
     - `Caravan <https://github.com/kratzert/Caravan>`_
     - Dataset
     - ``Implemented``
     - None
     - A synthetic-backed Caravan adapter is registered for streamflow smoke benchmarking.
   * - Flood
     - `WaterBench <https://github.com/uihilab/WaterBench>`_
     - Dataset
     - ``Implemented``
     - None
     - A synthetic-backed WaterBench adapter is registered for streamflow smoke benchmarking.
   * - Flood
     - `FloodCast <https://github.com/HydroPML/FloodCast>`_
     - Baseline
     - ``Implemented``
     - :doc:`FloodCast <modules/models_floodcast>`
     - The model adapter is implemented, but FloodCastBench-backed evaluation is not wired yet.
   * - Flood
     - `FloodCastBench <https://github.com/HydroPML/FloodCastBench>`_
     - Benchmark
     - ``Implemented``
     - None
     - A synthetic-backed FloodCastBench-style inundation adapter is registered.
   * - Flood
     - `UrbanFloodCast <https://github.com/HydroPML/UrbanFloodCast>`_
     - Baseline
     - ``Implemented``
     - :doc:`UrbanFloodCast <modules/models_urbanfloodcast>`
     - The model adapter is implemented on synthetic inundation fixtures today.
   * - Flood
     - `HydroBench <https://github.com/EMscience/HydroBench>`_
     - Benchmark / Diagnostics
     - ``Implemented``
     - None
     - A synthetic-backed HydroBench adapter is registered for streamflow smoke benchmarking.
   * - Flood
     - `google-research/flood-forecasting <https://github.com/google-research/flood-forecasting>`_
     - Reference Baseline
     - ``Implemented``
     - :doc:`Google Flood Forecasting <modules/models_google_flood_forecasting>`
     -  
   * - Hurricane / Tropical Cyclone
     - `Hurricast <https://github.com/leobix/hurricast>`_
     - Baseline
     - ``Implemented``
     - :doc:`Hurricast <modules/models_hurricast>`
     - The model adapter is implemented, but the real TCBench / IBTrACS data path is still missing.
   * - Hurricane / Tropical Cyclone
     - `tropicalcyclone_MLP <https://github.com/wenweixu/tropicalcyclone_MLP>`_
     - Baseline
     - ``Implemented``
     - :doc:`Tropical Cyclone MLP <modules/models_tropicalcyclone_mlp>`
     - The model adapter is implemented as a basin-filtered storm baseline.
   * - Hurricane / Tropical Cyclone
     - `TCIF-fusion <https://github.com/wangchong96/TCIF-fusion>`_
     - Baseline
     - ``Implemented``
     - :doc:`TCIF-fusion <modules/models_tcif_fusion>`
     - The model adapter is implemented behind the shared storm evaluator.
   * - Hurricane / Tropical Cyclone
     - `SAF-Net <https://github.com/xuguangning1218/TI_Prediction>`_
     - Baseline
     - ``Implemented``
     - :doc:`SAF-Net <modules/models_saf_net>`
     - The model adapter is implemented behind the shared storm evaluator.
   * - Hurricane / Tropical Cyclone
     - `TropiCycloneNet <https://github.com/xiaochengfuhuo/TropiCycloneNet>`_
     - Baseline
     - ``Implemented``
     - :doc:`TropiCycloneNet <modules/models_tropicyclonenet>`
     - The model adapter is implemented, but the public benchmark/data track remains synthetic-first.
   * - Hurricane / Tropical Cyclone
     - `TropiCycloneNet-Dataset <https://github.com/xiaochengfuhuo/TropiCycloneNet-Dataset>`_
     - Dataset
     - ``Implemented``
     - None
     - A synthetic-backed TropiCycloneNet-Dataset adapter is registered.
   * - Hurricane / Tropical Cyclone
     - `TCBench Alpha <https://github.com/msgomez06/TCBench_Alpha>`_
     - Benchmark
     - ``Implemented``
     - None
     - A synthetic-backed TCBench Alpha adapter is registered.
   * - Hurricane / Tropical Cyclone
     - `IBTrACS <https://www.ncei.noaa.gov/products/international-best-track-archive>`_
     - Dataset
     - ``Implemented``
     - None
     - A synthetic-backed IBTrACS adapter is registered.
   * - Hurricane / Tropical Cyclone
     - `GraphCast / GenCast <https://github.com/google-deepmind/graphcast>`_
     - Foundation Adapter
     - ``Experimental``
     - :doc:`GraphCast TC Adapter <modules/models_graphcast_tc>`
     - The current wrapper is intentionally lightweight and should not be counted as stable core coverage.
   * - Hurricane / Tropical Cyclone
     - `Pangu-Weather <https://github.com/198808xc/Pangu-Weather>`_
     - Foundation Adapter
     - ``Experimental``
     - :doc:`Pangu TC Adapter <modules/models_pangu_tc>`
     - The current wrapper is intentionally lightweight and should not be counted as stable core coverage.
   * - Hurricane / Tropical Cyclone
     - `FourCastNet <https://github.com/NVlabs/FourCastNet>`_
     - Foundation Adapter
     - ``Experimental``
     - :doc:`FourCastNet TC Adapter <modules/models_fourcastnet_tc>`
     - The current wrapper is intentionally lightweight and should not be counted as stable core coverage.

Current Public Non-Core Implementations
---------------------------------------

These entries remain in the public catalog, but they are not counted as
part of the current core method set.

.. list-table::
   :widths: 18 18 28 36
   :header-rows: 1
   :class: dataset-list

   * - Hazard Family
     - Catalog Status
     - Public Entry
     - Why it is non-core
   * - Wildfire
     - ``variant``
     - :doc:`CNN-ASPP <modules/models_wildfire_aspp>`
     - Implemented outside the current core method set and kept public as an additional model.
   * - Earthquake
     - ``variant``
     - :doc:`WaveCastNet <modules/models_wavecastnet>`
     - Implemented outside the current core method set and kept public as an additional model.
   * - Flood
     - ``variant``
     - :doc:`HydroGraphNet <modules/models_hydrographnet>`
     - Implemented outside the current core method set and kept public as an additional model.
   * - Tropical Cyclone
     - ``experimental``
     - :doc:`FourCastNet TC Adapter <modules/models_fourcastnet_tc>`
     - Wrapper-style experimental adapter pending stronger benchmark and dataset support.
   * - Tropical Cyclone
     - ``experimental``
     - :doc:`GraphCast TC Adapter <modules/models_graphcast_tc>`
     - Wrapper-style experimental adapter pending stronger benchmark and dataset support.
   * - Tropical Cyclone
     - ``experimental``
     - :doc:`Pangu TC Adapter <modules/models_pangu_tc>`
     - Wrapper-style experimental adapter pending stronger benchmark and dataset support.

Execution Note
--------------

Use `.github/ROADMAP_EXECUTION.md <https://github.com/LabRAI/PyHazards/blob/main/.github/ROADMAP_EXECUTION.md>`_
as the checked-in multi-agent handoff for finishing the remaining roadmap work.