Update taxonomy for 2025 UNDRR-ISC Hazard Information Profiles (#32)

* Update taxonomy.md with 2025 UNDRR-ISC Hazard Information Profiles and key changes

* Add complete 2025 Hazard List to taxonomy.md

* Update taxonomy.md for 2025 UNDRR-ISC Hazard Information Profiles and cross-classification mapping

* Update hazard mappings in README files for 2025 standards

* Update hazard codes in various JSON files to reflect new classifications

* Update README files to reflect 2025 UNDRR-ISC Hazard Information Profiles and code mappings

* Update GDACS README to enhance mapping of event types to 2025 UNDRR-ISC hazard profiles

* Update IDMC README to include 2025 UNDRR-ISC hazard type mapping and classification codes

* Update DesInventar README to reflect 2025 UNDRR-ISC hazard code mapping and cross-classification

* Update EM-DAT README to include 2025 UNDRR-ISC hazard type mapping and cross-classification details

* Update GFD and IDU README files to include 2025 UNDRR-ISC hazard type mapping and classification details

* Update IFRC DREF README to include 2025 UNDRR-ISC hazard type mapping and classification details

* Update PDC README to include 2025 UNDRR-ISC hazard type mapping and classification details

* Update USGS README to include 2025 UNDRR-ISC hazard type mapping and classification details

* Update hazard codes across various JSON files to include new classifications and ensure consistency in event descriptions. Added codes for floods, earthquakes, and wildfires, enhancing data accuracy for impacted regions. Adjusted titles for clarity and corrected special characters in location names.

* Update README and JSON schema to enforce UNDRR-ISC 2025 hazard code requirements. Specify that hazard items must include at least one code and allow for additional GLIDE and EM-DAT codes, while limiting the total to three for clarity.

* Update README and JSON schema to clarify UNDRR-ISC 2025 hazard code requirements. Specify that hazard items must have exactly one UNDRR-ISC code, with optional GLIDE and EM-DAT codes, and provide validation notes for JSON Schema limitations.

* Update README to specify hazard code requirements. Enforce that hazard items must have exactly one UNDRR-ISC 2025 code, with optional GLIDE and EM-DAT codes, and clarify validation limitations in JSON Schema.

* Update taxonomy to correct Mpox classification code from BI0204 to BI0224 for accuracy in biological hazard listings.

* Remove 'cluster' field from hazard detail and update JSON schema to require 'severity_value' and 'severity_unit'. Add new GDACS hazard JSON example for a flood event in Spain.

* Update example links in README to reflect correct file paths for flood hazard STAC items.

* Update hazard codes for Cyclone across multiple sources and examples

- Changed Cyclone hazard code from MH0309 to MH0306 in DesInventar, EM-DAT, GDACS, IDMC, IFRC-DREF, PDC, and related examples.
- Updated documentation to reflect the new classification for Cyclone or Depression.

* Refactor README to improve formatting and clarity of item properties and hazard details

* Remove 'cluster' field from hazard detail and set 'severity_value' to 0 in GDACS hazard JSON example for flood event in Spain.

* Update CHANGELOG to reflect changes in hazard information profiles and schema updates

* Add unreleased section link to CHANGELOG for future reference

Author: emmanuelmathot

CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+
+### Changed
+
+- Updated taxonomy for 2025 UNDRR-ISC Hazard Information Profiles [#32](https://github.com/IFRCGo/monty-stac-extension/pull/32)
+
+### Fixed
+
+- Mandatory severity_value and severity_unit fields in hazard_detail reflected in json schema [#32](https://github.com/IFRCGo/monty-stac-extension/pull/32)
+
+### Removed
+
+- Removed cluster code from hazard detail as we have chapeau hazard codes now [#32](https://github.com/IFRCGo/monty-stac-extension/pull/32)
+
 ## [1.0.0] - 2025-05-27
 
 Initial release of the Monty STAC Extension specification.
@@ -68,4 +84,5 @@ Initial release of the Monty STAC Extension specification.
 - Some features may be subject to change based on community feedback
 - Additional sources may be added in future releases
 
+[Unreleased]: https://github.com/IFRCGo/monty-stac-extension/releases/tag/v1.0.0..HEAD
 [1.0.0]: https://github.com/IFRCGo/monty-stac-extension/releases/tag/v1.0.0

README.md

@@ -173,7 +173,8 @@ The event class has the following attributes:
 - **country_codes**: The country codes of the countries affected by the event.
   The country codes are based on the [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) standard.
 - **hazard_codes**: The hazard codes of the hazards affecting the event.
-  The hazard codes are based on the [multiple classification systems](./taxonomy.md#hazards)
+  The hazard codes are based on the **[2025 UNDRR-ISC Hazard Information Profiles](./taxonomy.md#2025-update)** (reference classification system).
+  For interoperability, codes from [other classification systems](./taxonomy.md#hazards) are **recommended** to also be included.
 - **correlation_id**: The unique identifier assigned by the Monty system to the reference event.  It is used to "pair" all the instances of the event. More information about the correlation identifier can be found [here](./correlation_identifier.md).
 - **keywords**: A list of keywords that describe the event. This list includes the human-readable names of
   - the countries affected by the event

docs/model/README.md

@@ -152,34 +152,39 @@ Here is the mapping of fields from Desinventar XML to STAC event items:
 
 #### Hazard Code Mapping
 
-The following table shows how Desinventar event types map to [UNDRR-ISC Hazard Information Profiles](../../taxonomy.md#hazards):
-
-| Desinventar Event | Hazard Code | Description      |
-| ----------------- | ----------- | ---------------- |
-| ALLUVION          | MH0051      | Mud flow         |
-| AVALANCHE         | MH0050      | Avalanche        |
-| COASTAL EROSION   | EN0020      | Coastal erosion  |
-| COLD WAVE         | MH0049      | Cold wave        |
-| CYCLONE           | MH0057      | Tropical cyclone |
-| DROUGHT           | MH0035      | Drought          |
-| EARTHQUAKE        | GH0001      | Earthquake       |
-| ELECTRIC STORM    | MH0002      | Lightning        |
-| EROSION           | EN0019      | Soil erosion     |
-| FLASH FLOOD       | MH0006      | Flash flood      |
-| FLOOD             | FL          | Flood (general)  |
-| FOG               | MH0016      | Fog              |
-| FOREST FIRE       | EN0013      | Forest fire      |
-| FROST             | MH0043      | Frost            |
-| HAIL STORM        | MH0036      | Hail             |
-| HEAT WAVE         | MH0047      | Heat wave        |
-| LAHAR             | GH0013      | Lahar            |
-| LANDSLIDE         | GH0007      | Landslide        |
-| LIQUEFACTION      | GH0003      | Liquefaction     |
-| SANDSTORM         | MH0015      | Dust/sand storm  |
-| SNOW STORM        | MH0039      | Snow storm       |
-| STORM SURGE       | MH0027      | Storm surge      |
-| TSUNAMI           | MH0029      | Tsunami          |
-| TORNADO           | MH0060      | Tornado          |
+DesInventar uses its own hazard classification and must follow the **2025 UNDRR-ISC** code as the **reference classification** for the Monty extension. The following table provides cross-classification across multiple systems:
+
+| DesInventar Event | GLIDE | EM-DAT              | **UNDRR-ISC 2025** (Reference) | Cluster    | Description                     |
+| ----------------- | ----- | ------------------- | ------------------------------ | ---------- | ------------------------------- |
+| ALLUVION          | MS    | nat-hyd-mmw-mud     | **GH0303**                     | GEO-GFAIL  | Flows (includes mudflow)        |
+| AVALANCHE         | AV    | nat-geo-mmd-ava     | **MH0801**                     | MH-TERR    | Avalanche                       |
+| COASTAL EROSION   | OT    | nat-geo-env-coa     | **GH0405**                     | GEO-OTHER  | Coastal Erosion & Accretion     |
+| COLD WAVE         | CW    | nat-met-ext-col     | **MH0502**                     | MH-TEMP    | Cold Wave                       |
+| CYCLONE           | TC    | nat-met-sto-tro     | **MH0306**                     | MH-WIND    | Cyclone or Depression           |
+| DROUGHT           | DR    | nat-cli-dro-dro     | **MH0401**                     | MH-PRECIP  | Drought                         |
+| EARTHQUAKE        | EQ    | nat-geo-ear-gro     | **GH0101**                     | GEO-SEIS   | Earthquake                      |
+| ELECTRIC STORM    | ST    | nat-met-sto-lig     | **MH0102**                     | MH-CONV    | Lightning (electrical storm)    |
+| EROSION           | OT    | nat-geo-env-soi     | **GH0403**                     | GEO-OTHER  | Soil Erosion                    |
+| FLASH FLOOD       | FF    | nat-hyd-flo-fla     | **MH0603**                     | MH-WATER   | Flash Flooding                  |
+| FLOOD             | FL    | nat-hyd-flo-flo     | **MH0600**                     | MH-WATER   | Flooding (chapeau)              |
+| FOG               | OT    | nat-met-fog-fog     | **MH0202**                     | MH-PART    | Fog                             |
+| FOREST FIRE       | WF    | nat-cli-wil-for     | **EN0205**                     | ENV-FOREST | Wildfires                       |
+| FROST             | OT    | nat-met-ext-sev     | **MH0505**                     | MH-TEMP    | Frost (Hoar Frost)              |
+| HAIL STORM        | ST    | nat-met-sto-hai     | **MH0404**                     | MH-PRECIP  | Hail                            |
+| HEAT WAVE         | HT    | nat-met-ext-hea     | **MH0501**                     | MH-TEMP    | Heatwave                        |
+| LAHAR             | VO    | nat-geo-vol-lah     | **GH0204**                     | GEO-VOLC   | Lahars                          |
+| LANDSLIDE         | LS    | nat-geo-mmd-lan     | **GH0300**                     | GEO-GFAIL  | Gravitational Mass Movement     |
+| LIQUEFACTION      | EQ    | nat-geo-ear-gro     | **GH0307**                     | GEO-GFAIL  | Liquefaction                    |
+| SANDSTORM         | VW    | nat-met-sto-san     | **MH0201**                     | MH-PART    | Dust Storm or Sandstorm         |
+| SNOW STORM        | OT    | nat-met-sto-bli     | **MH0406**                     | MH-PRECIP  | Snow Storm                      |
+| STORM SURGE       | SS    | nat-met-sto-sur     | **MH0703**                     | MH-MARINE  | Storm Surge                     |
+| TSUNAMI           | TS    | nat-geo-ear-tsu     | **MH0705**                     | MH-MARINE  | Tsunami                         |
+| TORNADO           | TO    | nat-met-sto-tor     | **MH0305**                     | MH-WIND    | Tornado                         |
+
+> [!NOTE]
+> All three classification codes (GLIDE, EM-DAT, UNDRR-ISC 2025) should be included in the `monty:hazard_codes` array for maximum interoperability. More specific [hazard codes](../../taxonomy.md#complete-2025-hazard-list) can be added following the characteristics of the event.
+
+This mapping enables standardized hazard categorization while preserving DesInventar's original classification in the source properties.
 
 ### Hazard Item
 

docs/model/sources/DesInventar/README.md

@@ -156,5 +156,31 @@ Here is a table with the fields that are mapped from the EM-DAT event to the STA
 | [start_datetime](https://github.com/radiantearth/stac-spec/blob/master/commons/common-metadata.md#date-and-time-range) | start year + start month + start day                                                                         | Start date of the disaster converted in UTC ISO 8601 format. Start year is mandatory while month and day might not always be available. If no start day, keep 1 (start of the month) and set the flag missing_startday to true.                            |
 | [end_datetime](https://github.com/radiantearth/stac-spec/blob/master/commons/common-metadata.md#date-and-time-range)   | start year + start month + start day                                                                         | End date of the event converted in UTC ISO 8601 format                                                                                                                                                                                                     |
 | [monty:country_codes](https://github.com/IFRCGo/monty-stac-extension#montycountry_codes)\[0]                                                       | iso                                                                                                          | ISO3 code of the country where the event occurred. Keywords shall also contain the human readable country name                                                                                                                                             |
-| [monty:hazard_codes](https://github.com/IFRCGo/monty-stac-extension#montyhazard_codes)                                                             | Classification Key                                                                                           | [EN-DAT CRED Classification Key](../../taxonomy.md#em-dat-classification-tree                                                                                                                                                                              |
+| [monty:hazard_codes](https://github.com/IFRCGo/monty-stac-extension#montyhazard_codes)                                                             | Classification Key                                                                                           | List of hazard codes converted following the [Hazard Type Mapping](#hazard-type-mapping)                                                                                                                                                                   |
 | [`via` link](https://github.com/radiantearth/stac-spec/blob/master/commons/assets.md) in [links]                       | graphql request                                                                                              | Link to the EM-DAT event details page                                                                                                                                                                                                                      |
+
+#### Hazard Type Mapping
+
+EM-DAT uses the [EM-DAT CRED Classification Tree](../../taxonomy.md#em-dat-cred-classification-tree) and must be mapped to the **2025 UNDRR-ISC** code as the **reference classification** for the Monty extension. The full cross-classification mapping is available in the [taxonomy documentation](../../taxonomy.md#cross-classification-mapping).
+
+The EM-DAT Classification Key (e.g., `nat-hyd-flo-flo`) should be used along with the corresponding 2025 UNDRR-ISC code (e.g., `MH0600`) for maximum interoperability.
+
+**Example mappings:**
+
+| EM-DAT Classification Key | GLIDE | **UNDRR-ISC 2025** (Reference) | Cluster    | Description             |
+| ------------------------- | ----- | ------------------------------ | ---------- | ----------------------- |
+| nat-hyd-flo-flo           | FL    | **MH0600**                     | MH-WATER   | Flooding (chapeau)      |
+| nat-geo-ear-gro           | EQ    | **GH0101**                     | GEO-SEIS   | Earthquake              |
+| nat-met-sto-tro           | TC    | **MH0306**                     | MH-WIND    | Cyclone or Depression   |
+| nat-cli-dro-dro           | DR    | **MH0401**                     | MH-PRECIP  | Drought                 |
+| nat-geo-vol-vol           | VO    | **GH0201**                     | GEO-VOLC   | Lava Flows              |
+| nat-geo-ear-tsu           | TS    | **MH0705**                     | MH-MARINE  | Tsunami                 |
+| nat-cli-wil-for           | WF    | **EN0205**                     | ENV-FOREST | Wildfires               |
+| nat-met-ext-hea           | HT    | **MH0501**                     | MH-TEMP    | Heatwave                |
+| nat-met-ext-col           | CW    | **MH0502**                     | MH-TEMP    | Cold Wave               |
+| nat-geo-mmd-lan           | LS    | **GH0300**                     | GEO-GFAIL  | Gravitational Mass Movement (chapeau) |
+
+> [!NOTE]
+> All three classification codes (GLIDE, EM-DAT, UNDRR-ISC 2025) should be included in the `monty:hazard_codes` array for maximum interoperability. The complete mapping table with all EM-DAT disaster types is available in the [taxonomy cross-classification mapping](../../taxonomy.md#cross-classification-mapping). More specific [hazard codes](../../taxonomy.md#complete-2025-hazard-list) can be added following the characteristics of the event.
+
+This mapping enables standardized hazard categorization while preserving EM-DAT's original classification in the source properties.