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

Tropical Cyclone Benchmark
==========================

Overview
--------

The tropical cyclone benchmark family is the single storm evaluator used by the hurricane-specific and all-basin tropical-cyclone smoke configs.

Current coverage is synthetic-backed, but the same evaluator contract already scores core storm baselines and experimental weather-model adapters.

At a Glance
-----------

.. grid:: 1 2 4 4
   :gutter: 2
   :class-container: catalog-grid

   .. grid-item-card:: Kind
      :class-card: catalog-stat-card

      .. container:: catalog-stat-value

         Family

      .. container:: catalog-stat-note

         Family benchmark or external ecosystem view.

   .. grid-item-card:: Hazard Family
      :class-card: catalog-stat-card

      .. container:: catalog-stat-value

         Tropical Cyclone

      .. container:: catalog-stat-note

         Public hazard grouping used on the benchmark index page.

   .. grid-item-card:: Support Status
      :class-card: catalog-stat-card

      .. container:: catalog-stat-value

         :bdg-info:`Synthetic-backed`

      .. container:: catalog-stat-note

         Current maturity of the adapter or evaluator path.

   .. grid-item-card:: Linked Models
      :class-card: catalog-stat-card

      .. container:: catalog-stat-value

         8

      .. container:: catalog-stat-note

         8 models


Benchmark Mapping
-----------------

**Shared benchmark key:** ``tc``

**Registered class:** ``TropicalCycloneBenchmark``

Mapped benchmark ecosystems
~~~~~~~~~~~~~~~~~~~~~~~~~~~

:doc:`IBTrACS </benchmarks/ibtracs>`, :doc:`TCBench Alpha </benchmarks/tcbench_alpha>`, :doc:`TropiCycloneNet-Dataset </benchmarks/tropicyclonenet_dataset>`.

.. dropdown:: Supported Tasks
   :class-container: catalog-dropdown

   - Track + Intensity

.. dropdown:: Key Metrics
   :class-container: catalog-dropdown

   - ``track_error``
   - ``intensity_mae``

.. dropdown:: Smoke Configs
   :class-container: catalog-dropdown

   - ``hurricast_smoke.yaml``
   - ``tropicalcyclone_mlp_smoke.yaml``
   - ``tropicyclonenet_smoke.yaml``
   - ``saf_net_smoke.yaml``
   - ``tcif_fusion_smoke.yaml``
   - ``graphcast_tc_smoke.yaml``
   - ``pangu_tc_smoke.yaml``
   - ``fourcastnet_tc_smoke.yaml``

.. dropdown:: Linked Models
   :class-container: catalog-dropdown

   :doc:`Hurricast </modules/models_hurricast>`, :doc:`Tropical Cyclone MLP </modules/models_tropicalcyclone_mlp>`, :doc:`TropiCycloneNet </modules/models_tropicyclonenet>`, :doc:`SAF-Net </modules/models_saf_net>`, :doc:`TCIF-fusion </modules/models_tcif_fusion>`, :doc:`GraphCast TC Adapter </modules/models_graphcast_tc>`, :doc:`Pangu TC Adapter </modules/models_pangu_tc>`, :doc:`FourCastNet TC Adapter </modules/models_fourcastnet_tc>`.

.. dropdown:: Notes
   :class-container: catalog-dropdown

   - IBTrACS, TCBench Alpha, and TropiCycloneNet-Dataset are surfaced as the public storm benchmark ecosystems.