Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions docs/about/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,12 @@ This page lists changes to the Risk Data Library Standard.
- Make `SimpleHazard.type` and `SimpleHazard.process` required.
- Align `enums` with codelist CSVs.
- Remove `Location.geometry`.
- [#405](https://github.com/GFDRR/rdl-standard/pull/405):
- Make `.description` required
- Reorder some properties
- Move repeated impact properties from `Losses` and `Function` to new `Impact` definition
- Refactor to reduce repetition and standardise use of allOf keyword
- [#434](https://github.com/GFDRR/rdl-standard/pull/434) - Update `Exposure_item.asset_type.scheme` description.

### Codelists

Expand Down Expand Up @@ -109,11 +115,7 @@ This page lists changes to the Risk Data Library Standard.
- 'disruption_days'
- 'disruption_loss'
- 'displaced_days'
- [#405](https://github.com/GFDRR/rdl-standard/pull/405):
- Make `.description` required
- Reorder some properties
- Move repeated impact properties from `Losses` and `Function` to new `Impact` definition
- Refactor to reduce repetition and standardise use of allOf keyword
- [#434](https://github.com/GFDRR/rdl-standard/pull/434) - Remove 'USHS_EHP' and 'INFORM' from `classification_scheme.csv`.

### Normative documentation

Expand All @@ -123,6 +125,7 @@ This page lists changes to the Risk Data Library Standard.

* [#429](https://github.com/GFDRR/rdl-standard/pull/429) - Add guidance on describing location-only exposure data.
* [#431](https://github.com/GFDRR/rdl-standard/pull/431) - Update [What is the RDLS?](../rdl/what.md).
- [#434](https://github.com/GFDRR/rdl-standard/pull/434) - Remove `guides/metadata/mappings.md` in favour of mappings documented in codelists.

## 0.2.0 - 2023-09-08

Expand Down
3 changes: 1 addition & 2 deletions docs/guides/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
# Guidance

This section provides guidance on how to publish RDLS metadata, guidance on how to publish risk datasets and mappings between existing risk taxonomies and RDLS.
This section provides guidance on how to publish RDLS metadata and guidance on how to publish risk datasets.

```{eval-rst}
.. toctree::
:maxdepth: 2

metadata
datasets/index
mappings/index

```
11 changes: 0 additions & 11 deletions docs/guides/mappings/index.md

This file was deleted.

13 changes: 0 additions & 13 deletions docs/guides/mappings/undrr_isc_hip.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/guides/metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ If you are authoring new metadata by hand or converting existing metadata from a

If you are exporting existing metadata from a data catalog or database and you have access to a software developer, the suggested approach is to [export data in JSON format](#export-data-in-json-format).

If your risk datasets use terms from existing taxonomies or classifications, use the [taxonomy mappings](mappings/index.md) to identify the equivalent codes in RDLS.
If your risk datasets use terms from [EM-DAT](https://www.emdat.be/) or the [UNDRR Hazard Information Profiles](https://www.undrr.org/publication/documents-and-publications/hazard-information-profiles-hips-2025-version), use the mappings in the [hazard_type](../reference/codelists.md#hazard_type) and [process_type](../reference/codelists.md#process_type) codelists to identify the equivalent codes in RDLS.

If you plan to describe the spatial coverage of your risk data using coordinates, you might need to [transform your coordinates to the correct coordinate reference system](#transform-coordinates-between-coordinate-reference-systems).

Expand Down
2 changes: 1 addition & 1 deletion docs/rdl/other-standards.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

RDLS has been built based on existing open data standards.

In this section you will find a short summary of the core standards upon which the RDL data model has been built. For detailed mappings between existing risk taxonomies and RDLS, refer to the [taxonomy mappings](../guides/mappings/index.md).
In this section you will find a short summary of the core standards upon which the RDL data model has been built. For detailed mappings between existing risk taxonomies and RDLS, refer to the [hazard_type](../reference/codelists.md#hazard_type) and [process_type](../reference/codelists.md#process_type) codelists.

## General standards

Expand Down
5 changes: 3 additions & 2 deletions docs/reference/codelists.md
Original file line number Diff line number Diff line change
Expand Up @@ -788,6 +788,8 @@ The RDLS offers a classification of hazards that are more often required in disa

The hazard_type codelist classifies hazard phenomena by the main hazard to which they relate. Hazard phenomena can also be classified by the hazard process to which they relate. For more information, see the [process_type codelist](#process_type).

The hazard_type codelist includes a mapping from the RDLS hazard types to the hazard categories defined in the [UNDRR Hazard Information Profiles](https://www.undrr.org/publication/documents-and-publications/hazard-information-profiles-hips-2025-version).


````{dropdown} Codes

Expand Down Expand Up @@ -869,8 +871,7 @@ Download CSV file

### process_type

The process_type codelist classifies hazard phenomena by the hazard process to which they relate. Hazard phenomena can also be the main hazard to which they relate. For more information, see the [hazard_type codelist](#hazard_type). Process types are based primarily on the [UNDRR Hazard terminology](https://www.undrr.org/publication/hazard-definition-and-classification-review-technical-report).

The process_type codelist classifies hazard phenomena by the hazard process to which they relate. Hazard phenomena can also be the main hazard to which they relate. For more information, see the [hazard_type codelist](#hazard_type). Process types are based primarily on the [UNDRR Hazard terminology](https://www.undrr.org/publication/hazard-definition-and-classification-review-technical-report) and the codelist includes a mapping to [EM-DAT](https://www.emdat.be/) and the [UNDRR Hazard Information Profiles](https://www.undrr.org/publication/documents-and-publications/hazard-information-profiles-hips-2025-version).

````{dropdown} Codes

Expand Down
2 changes: 0 additions & 2 deletions schema/codelists/open/classification_scheme.csv
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,8 @@ GED4ALL,GED4ALL socio-economic taxonomy,The socio-economic taxonomy defined in t
MOVER,MOVER social vulnerability categories,The social vulnerability categories defined in the Multi-Hazard Open Vulnerability Platform for Evaluating Risk (MOVER).,https://www.gfdrr.org/en/publication/mover,Socio-economic index
GLIDE,Global Identifier Numbers,Identification codes generated by GLIDE since 2004 for all new disaster events reported by the Asian Disaster Reduction Center and GLIDE partner organizations.,https://www.glidenumber.net/glide/public/search/search.jsp,Distaster identifier
EMDAT,EM-DAT International Disaster Database,"EM-DAT contains data on the occurrence and impacts of over 26,000 mass disasters worldwide from 1900 to the present day. The database is compiled from various sources, including UN agencies, non-governmental organizations, reinsurance companies, research institutes, and press agencies. The Centre for Research on the Epidemiology of Disasters (CRED) distributes the data in open access for non-commercial use.",https://www.emdat.be/,Disaster identifier
USGS_EHP,USGS Earthquake Hazards Program,"The USGS monitors and reports on earthquakes globally, assigning each reported event a unique identifier. These event identifiers are used in the associated USGS products including PAGER, ShakeMap and DYFI.",https://earthquake.usgs.gov/earthquakes/search/,Disaster identifier
HAZUS,HAZUS Building Classification,The building occupancy and structural classification system used in FEMA's HAZUS multi-hazard loss estimation software. Categorizes structures by construction type and occupancy class for use in earthquake flood and hurricane loss modeling.,https://www.fema.gov/flood-maps/products-tools/hazus,Building taxonomy
CDC-SVI,CDC/ATSDR Social Vulnerability Index,A social vulnerability index developed by the U.S. Centers for Disease Control and Prevention (CDC) and Agency for Toxic Substances and Disease Registry (ATSDR) that uses U.S. Census data to rank census tracts on 16 social factors grouped into four themes: socioeconomic status; household characteristics; racial and ethnic minority status; and housing type and transportation.,https://www.atsdr.cdc.gov/place-health/php/svi/index.html,Socio-economic index
INFORM,INFORM Risk Index,A global open-source risk assessment framework for humanitarian crises and disasters developed under the Inter-Agency Standing Committee. INFORM measures risk across three composite dimensions — Hazard & Exposure; Vulnerability; and Lack of Coping Capacity — producing a country-level risk index updated annually.,https://www.inform-index.org/,Socio-economic index
EMS-98,European Macroseismic Scale 1998,The European Macroseismic Scale (EMS-98) is a standard seismic intensity scale that also classifies buildings into vulnerability classes A through F based on their resistance to earthquake damage. It is widely used across Europe for earthquake impact assessment and macroseismic data compilation.,https://www.gfz.de/en/EMS-98%20%20-%20%20European%20Macroseismic%20Scale%201998,Building taxonomy
PAGER,PAGER-STR Building Taxonomy,The PAGER Structural Type (PAGER-STR) taxonomy is a global classification system for building structural types developed by the USGS as part of the Prompt Assessment of Global Earthquakes for Response (PAGER) program. It provides standardized structural building types for rapid earthquake loss estimation.,https://earthquake.usgs.gov/data/pager/,Building taxonomy
OED,Open Exposure Data,The Open Exposure Data (OED) standard is an open-source property exposure data format developed and maintained by the Oasis Loss Modelling Framework. OED provides a standardized schema for representing insured property exposure data enabling interoperability between catastrophe models and consistent loss estimation across the insurance industry.,https://oasislmf.github.io/sections/OED.html,Building taxonomy
Expand Down
7 changes: 6 additions & 1 deletion schema/rdls_schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -1718,7 +1718,12 @@
"asset_type": {
"title": "Asset type",
"description": "The type of asset",
"$ref": "#/$defs/Classification"
"$ref": "#/$defs/Classification",
"properties": {
"scheme": {
"description": "The scheme or codelist from which the classification code is taken, using the open [classification_scheme](https://docs.riskdatalibrary.org/en/{{version}}/reference/codelists/#classification-scheme) codelist. Use of GED4ALL is recommended."
}
}
},
"metrics": {
"title": "Exposure metrics",
Expand Down
1 change: 1 addition & 0 deletions tests/test_schema.py
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ def validate_metadata_presence_allow_missing(pointer):
or pointer.startswith('/$defs/Hazard')
or pointer.startswith('/$defs/HazardWithTrigger')
or pointer.startswith('/$defs/Resource/anyOf/')
or pointer.startswith('/$defs/Exposure_item/properties/asset_type/properties/scheme')
)

validate_metadata_presence_kwargs = {
Expand Down
Loading