← All entries
Reference

Doc — Algorithm Catalog & the STAC Naming Standard

The three-tab data model, the two entry modes, and the enforcement chain that keeps `YYYYMM_Hazard_Location` honest across rules.ts, validate_data.py and CI.

Reference docsdisastersstacvalidationstandardsdata-model

◎ What it solves

Answers “why was my valid-looking event name rejected?” — and documents the deliberate, one-directional divergence from upstream DPS validation.

⚠ Limitations & Risks

Every catalog entry must acknowledge at least one limitation or risk.

What’s in it

The catalog’s data model (algorithms, events, hazards, requests), the two entry modes that share one filter state, and — the substantial part — how the naming standard is enforced rather than merely documented: one source of truth in src/rules.ts, a 1:1 mirror in scripts/validate_data.py, a parity test that fails if the two ever disagree, and a CI workflow that runs all of it on every PR.

It also records the knowing divergence from upstream. Upstream’s regex ends with .+, so the LOCATION slot swallows extra underscores and 202501_Tropical_Cyclone_CA parses as hazard=Tropical, location=Cyclone_CA — writing a wrong HAZARD GeoTIFF tag. This catalog ends with _[^_]+$ instead, making 3+ underscores a hard error. The divergence is one-directional and safe: everything this catalog accepts, DPS accepts too.

Read it when