From a7f915ffaa1c53f1961219d4cbc02f48116f2d93 Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Tue, 29 Aug 2023 11:34:59 +1200 Subject: [PATCH 01/11] docs: Increase content width --- docs/_static/extra.css | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/_static/extra.css b/docs/_static/extra.css index 31856b06..c3c45270 100644 --- a/docs/_static/extra.css +++ b/docs/_static/extra.css @@ -60,7 +60,9 @@ margin-bottom: 20px; margin-bottom: 20px; margin-right: 20px; } - +.wy-nav-content { + max-width: 1000px !important; +} .wy-side-nav-search { background-color: #0b3860; } @@ -71,4 +73,4 @@ margin-right: 20px; svg[id^="mermaid-"] { width: 100%; max-width: 80em; -} \ No newline at end of file +} From 7ab1ecc48228406113d0b4cc2a6b794128255e95 Mon Sep 17 00:00:00 2001 From: odscjen Date: Thu, 31 Aug 2023 11:40:06 +0100 Subject: [PATCH 02/11] update disaster_identifier to array of Classification objects --- docs/rdl/other-standards.md | 5 ----- docs/reference/schema.md | 1 + schema/codelists/open/classification_scheme.csv | 3 +++ schema/rdls_schema.json | 16 +++++++++++----- 4 files changed, 15 insertions(+), 10 deletions(-) diff --git a/docs/rdl/other-standards.md b/docs/rdl/other-standards.md index 517bfadf..4a12fda3 100644 --- a/docs/rdl/other-standards.md +++ b/docs/rdl/other-standards.md @@ -14,11 +14,6 @@ In 2018 an international consortium led by the British Geological Survey develop In this standard, we developed a list of hazard type codes and process type codes which are used as a reference in the hazard, vulnerability and loss components of the standard, and facilitate matching of appropriate vulnerability functions to hazard data, for example. Details about the development are reported [here](https://riskdatalibrary.org/resources). -**GLIDE disaster event identifier**: -Since the beginning of 2004, GLobal IDEntifier numbers (GLIDE) are produced at (GLIDEnumber.net) for all new disaster events reported by partner institutions and those discovered by ADRC. -A GLIDE number comprises two letters to identify the disaster type (e.g. EQ - earthquake); the year of the disaster; a six-digit, sequential disaster number; and the three-letter ISO code for country of occurrence. E.g., the GLIDE number for West-India Earthquake in India is: EQ-2001-000033-IND. This number is posted by the above organizations and in many other websites, on their documents relating to that particular disaster and gradually other partners will include it in whatever information they generate. As information suppliers join in this initiative, documents and data pertaining to specific events may be easily retrieved from various sources, or linked together using the unique GLIDE numbers. List of services using GLIDE: https://glidenumber.net/glide/public/links.jsp -The RDL Standard uses a GLIDE number in the `hazard.event` object, to denote the historical event to which hazard event data relates, e.g., the simulated hazard intensity footprint of that event. - ### Hazard taxonomies The RDL project performed a review of the most relevant hazard taxonomies and derived a classification focusing on those hazards and processes that are more often required in disaster risk assessments, while mapping and matching alternative definitions into one consistent framework. There are several existing taxonomies that could have been adopted to describe hazard data: diff --git a/docs/reference/schema.md b/docs/reference/schema.md index 12cee506..46d68a62 100644 --- a/docs/reference/schema.md +++ b/docs/reference/schema.md @@ -1195,6 +1195,7 @@ jsonpointer: /$defs/Classification/description This sub-schema is referenced by the following properties: - [`vulnerability/se_category`](rdls_schema.json,/properties/vulnerability,se_category) +- [`Event/disaster_identifiers`](rdls_schema.json,/$defs/Event,disaster_identifiers) Each `Classification` has the following fields: diff --git a/schema/codelists/open/classification_scheme.csv b/schema/codelists/open/classification_scheme.csv index 61f714ff..c7581e4b 100644 --- a/schema/codelists/open/classification_scheme.csv +++ b/schema/codelists/open/classification_scheme.csv @@ -1,3 +1,6 @@ Code,Title,Definition,Source,Category GED4ALL-socio-economic,GED4ALL socio-economic taxonomy,The socio-economic taxonomy defined in the Global Exposure Database for Multi-Hazard Risk Analysis (GED4ALL).,https://wiki.openstreetmap.org/wiki/GED4ALL#Socio-Economic,Socio-economic index MOVER_social_vulnerability_categories,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 diff --git a/schema/rdls_schema.json b/schema/rdls_schema.json index 7d1ef29d..20f340f1 100644 --- a/schema/rdls_schema.json +++ b/schema/rdls_schema.json @@ -1813,11 +1813,14 @@ "description": "A locally unique identifier for this event.", "minLength": 1 }, - "disaster_identifier": { - "title": "Disaster identifier", - "type": "string", - "description": "The GLIDE number associated with this disaster event. A globally unique identifier for the event, assigned by [GLIDE](https://www.glidenumber.net/glide/public/search/search.jsp).", - "minLength": 1 + "disaster_identifiers": { + "title": "Disaster identifiers", + "type": "array", + "description": "Disaster identifiers for this event.", + "items": { + "$ref": "#/$defs/Classification" + }, + "minItems": 1 }, "calculation_method": { "title": "Model calculation method", @@ -2426,6 +2429,9 @@ "title": "Classification", "description": "A classification consists of at least two parts: an identifier for the list (scheme) from which the classification is taken, and an identifier for the category from that list being applied. It is useful to also publish a text label and/or URI that users can draw on to interpret the classification.", "type": "object", + "required": [ + "id" + ], "properties": { "scheme": { "title": "Scheme", From 6cb6bef7fbf4309cd8eafb64ead5d1ecae402dfb Mon Sep 17 00:00:00 2001 From: odscjen Date: Thu, 31 Aug 2023 11:43:00 +0100 Subject: [PATCH 03/11] update changelog --- docs/about/changelog.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/about/changelog.md b/docs/about/changelog.md index a0807181..a7184966 100644 --- a/docs/about/changelog.md +++ b/docs/about/changelog.md @@ -77,6 +77,9 @@ This page lists changes to the Risk Data Library Standard. - [#210](https://github.com/GFDRR/rdl-standard/pull/210) - Replace `resource.`url with `.access_url` and `download_url` - [#218](https://github.com/GFDRR/rdl-standard/pull/218) - `Vulnerability·taxonomy` removed from required array. - [#220](https://github.com/GFDRR/rdl-standard/pull/220) - Reorder top-level fields. +- [#232](https://github.com/GFDRR/rdl-standard/pull/232) + - Convert `disaster_identifiers` to array of `Classification` objects. + - Add new codes to classification_scheme.csv. ### Codelists From ba1d96c9abe872badee6d277c1b56893175c5535 Mon Sep 17 00:00:00 2001 From: odscjen Date: Thu, 31 Aug 2023 11:57:20 +0100 Subject: [PATCH 04/11] update reference/schema.md --- docs/about/changelog.md | 2 +- docs/reference/schema.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/about/changelog.md b/docs/about/changelog.md index a7184966..13b61754 100644 --- a/docs/about/changelog.md +++ b/docs/about/changelog.md @@ -77,7 +77,7 @@ This page lists changes to the Risk Data Library Standard. - [#210](https://github.com/GFDRR/rdl-standard/pull/210) - Replace `resource.`url with `.access_url` and `download_url` - [#218](https://github.com/GFDRR/rdl-standard/pull/218) - `Vulnerability·taxonomy` removed from required array. - [#220](https://github.com/GFDRR/rdl-standard/pull/220) - Reorder top-level fields. -- [#232](https://github.com/GFDRR/rdl-standard/pull/232) +- [#232](https://github.com/GFDRR/rdl-standard/pull/232) - Convert `disaster_identifiers` to array of `Classification` objects. - Add new codes to classification_scheme.csv. diff --git a/docs/reference/schema.md b/docs/reference/schema.md index 46d68a62..790d0d49 100644 --- a/docs/reference/schema.md +++ b/docs/reference/schema.md @@ -156,7 +156,7 @@ The following diagram shows key hazard component fields, with required fields hi "temporal": "", "events": [ { - "disaster_identifier": "", + "disaster_identifiers": "", "calculation_method": "", "description": "", "hazard": { @@ -165,7 +165,7 @@ The following diagram shows key hazard component fields, with required fields hi "intensity_measure": "", "trigger": "" }, - "occurence": "", + "occurrence": "", "footprints": [ { "intensity_measure": "", From 4f76c808eeb459feefbc2a5d7dcd745103d0f108 Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 11:13:21 +1200 Subject: [PATCH 05/11] schema/rdls_schema.json: Fix broken codelist reference URLs --- schema/rdls_schema.json | 70 ++++++++++++++++++++--------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/schema/rdls_schema.json b/schema/rdls_schema.json index e43dfb36..e43c3fc6 100644 --- a/schema/rdls_schema.json +++ b/schema/rdls_schema.json @@ -37,7 +37,7 @@ "risk_data_type": { "title": "Risk data type", "type": "array", - "description": "The types of risk data included in the dataset, from the closed [risk data type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#risk-data-type).", + "description": "The types of risk data included in the dataset, from the closed [risk_data_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#risk-data-type).", "items": { "type": "string", "enum": [ @@ -184,7 +184,7 @@ "properties": { "category": { "title": "Exposure category", - "description": "The category of the exposed assets, from the closed [exposure category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure_category).", + "description": "The category of the exposed assets, from the closed [exposure_category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure-category).", "type": "string", "codelist": "exposure_category.csv", "openCodelist": false, @@ -369,7 +369,7 @@ }, "category": { "title": "Exposure category", - "description": "The category of the exposed assets, from the closed [exposure category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure_category).", + "description": "The category of the exposed assets, from the closed [exposure_category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure-category).", "type": "string", "codelist": "exposure_category.csv", "openCodelist": false, @@ -424,7 +424,7 @@ "approach": { "title": "Vulnerability function approach", "type": "string", - "description": "The approach the vulnerability function is based upon, taken from the closed [function approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function_approach).", + "description": "The approach the vulnerability function is based upon, taken from the closed [function_approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function-approach).", "enum": [ "analytical", "empirical", @@ -438,7 +438,7 @@ "relationship": { "title": "Vulnerability impact relationship type", "type": "string", - "description": "The type of function relationships used to calculate the vulnerability impact values, taken from the closed [relationship type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship_type).", + "description": "The type of function relationships used to calculate the vulnerability impact values, taken from the closed [relationship_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship-type).", "enum": [ "discrete", "math_bespoke", @@ -459,7 +459,7 @@ "approach": { "title": "Fragility function approach", "type": "string", - "description": "The approach the fragility function is based upon, taken from the closed [function approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function_approach).", + "description": "The approach the fragility function is based upon, taken from the closed [function_approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function-approach).", "enum": [ "analytical", "empirical", @@ -473,7 +473,7 @@ "relationship": { "title": "Fragility impact relationship type", "type": "string", - "description": "The type of function relationships used to calculate the impact values, taken from the closed [relationship type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship_type).", + "description": "The type of function relationships used to calculate the impact values, taken from the closed [relationship type_codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship-type).", "enum": [ "discrete", "math_bespoke", @@ -486,7 +486,7 @@ "damage_scale_name": { "title": "Damage scale name", "type": "string", - "description": "The name of the damage scale used in the fragility function, taken from the open [damage scale name codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#damage_scale_name).", + "description": "The name of the damage scale used in the fragility function, taken from the open [damage_scale_name codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#damage-scale-name).", "codelist": "damage_scale_name.csv", "openCodelist": true, "minLength": 1 @@ -513,7 +513,7 @@ "approach": { "title": "Damage-to-loss function approach", "type": "string", - "description": "The approach the damage-to-loss impact function is based upon, taken from the closed [function approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function_approach).", + "description": "The approach the damage-to-loss impact function is based upon, taken from the closed [function_approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function-approach).", "enum": [ "analytical", "empirical", @@ -527,7 +527,7 @@ "relationship": { "title": "Damage-to-loss impact relationship type", "type": "string", - "description": "The type of function relationships used to calculate the damage-to-loss impact values, taken from the closed [relationship type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship_type).", + "description": "The type of function relationships used to calculate the damage-to-loss impact values, taken from the closed [relationship_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship-type).", "enum": [ "discrete", "math_bespoke", @@ -540,7 +540,7 @@ "damage_scale_name": { "title": "Damage scale name", "type": "string", - "description": "The name of the damage scale used in the damage-to-loss function, taken from the open [damage scale name codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#damage_scale_name).", + "description": "The name of the damage scale used in the damage-to-loss function, taken from the open [damage_scale_name codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#damage-scale-name).", "codelist": "damage_scale_name.csv", "openCodelist": true, "minLength": 1 @@ -567,7 +567,7 @@ "parameter": { "title": "Engineering demand parameter", "type": "string", - "description": "The name of the engineering demand parameter, taken from the open [engineering demand parameter codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#engineering_demand_parameter).", + "description": "The name of the engineering demand parameter, taken from the open [engineering_demand_parameter codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#engineering-demand-parameter).", "codelist": "engineering_demand_parameter.csv", "openCodelist": true, "minLength": 1 @@ -575,7 +575,7 @@ "approach": { "title": "Engineering demand impact function approach", "type": "string", - "description": "The approach the engineering demand impact function is based upon, taken from the closed [function approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function_approach).", + "description": "The approach the engineering demand impact function is based upon, taken from the closed [function_approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function-approach).", "enum": [ "analytical", "empirical", @@ -589,7 +589,7 @@ "relationship": { "title": "Engineering demand impact relationship type", "type": "string", - "description": "The type of function relationships used to calculate the engineering impact values, taken from the closed [relationship type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship_type).", + "description": "The type of function relationships used to calculate the engineering impact values, taken from the closed [relationship_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#relationship-type).", "enum": [ "discrete", "math_bespoke", @@ -695,7 +695,7 @@ }, "category": { "title": "Exposure category", - "description": "The category of the exposed assets, from the closed [exposure category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure_category).", + "description": "The category of the exposed assets, from the closed [exposure_category codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#exposure-category).", "type": "string", "codelist": "exposure_category.csv", "openCodelist": false, @@ -726,7 +726,7 @@ "type": { "title": "Loss type", "type": "string", - "description": "The type of loss described in the dataset, from the closed [loss type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#loss_type).", + "description": "The type of loss described in the dataset, from the closed [loss_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#loss-type).", "codelist": "loss_type.csv", "openCodelist": false, "enum": [ @@ -741,7 +741,7 @@ "approach": { "title": "Loss approach", "type": "string", - "description": "The approach the loss calculation function is based upon, taken from the closed [function approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function_approach).", + "description": "The approach the loss calculation function is based upon, taken from the closed [function_approach codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#function-approach).", "codelist": "function_approach.csv", "openCodelist": false, "enum": [ @@ -754,7 +754,7 @@ "hazard_analysis_type": { "title": "Event frequency type", "type": "string", - "description": "The type of occurrence frequency represented in the modelled scenario, from the closed [analysis type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#loss_type).", + "description": "The type of occurrence frequency represented in the modelled scenario, from the closed [analysis_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#loss-type).", "enum": [ "deterministic", "empirical", @@ -846,7 +846,7 @@ "media_type": { "title": "Media type", "type": "string", - "description": "The media type of the resource, from the open [media_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#media_type). For example a custom binary file has media_type 'application/octet-stream. A geojson file has the media_type 'application/geo+json'.", + "description": "The media type of the resource, from the open [media_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#media-type). For example a custom binary file has media_type 'application/octet-stream. A geojson file has the media_type 'application/geo+json'.", "codelist": "media_type.csv", "openCodelist": true, "minLength": 1 @@ -854,7 +854,7 @@ "format": { "title": "Format", "type": "string", - "description": "A human-readable description of the file format of the resource, taken from the open [data formats codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data_formats).", + "description": "A human-readable description of the file format of the resource, taken from the open [data_formats codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data-formats).", "codelist": "data_formats.csv", "openCodelist": true, "minLength": 1 @@ -1039,7 +1039,7 @@ "type": { "title": "type", "type": "string", - "description": "The nature of the source, from the closed [source type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#source_type).", + "description": "The nature of the source, from the closed [source_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#source-type).", "codelist": "source_type.csv", "openCodelist": false, "enum": [ @@ -1050,7 +1050,7 @@ "component": { "title": "Component", "type": "string", - "description": "The risk data component the source has been used in, from the closed [risk data type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#risk_data_type).", + "description": "The risk data component the source has been used in, from the closed [risk_data_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#risk-data-type).", "codelist": "risk_data_type.csv", "openCodelist": false, "enum": [ @@ -1538,7 +1538,7 @@ }, "type": { "title": "Hazard type", - "description": "The hazard type for this hazard, from the closed [hazard type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#hazard_type).", + "description": "The hazard type for this hazard, from the closed [hazard_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#hazard-type).", "type": "string", "codelist": "hazard_type.csv", "openCodelist": false, @@ -1623,7 +1623,7 @@ "properties": { "type": { "title": "Hazard type", - "description": "The hazard type for this hazard, from the closed [hazard type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#hazard_type).", + "description": "The hazard type for this hazard, from the closed [hazard_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#hazard-type).", "type": "string", "codelist": "hazard_type.csv", "openCodelist": false, @@ -1729,7 +1729,7 @@ "frequency_distribution": { "title": "Frequency distribution", "type": "string", - "description": "The frequency distribution assumed for the occurrence of events over a multi-year timeline, from the [frequency distribution codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#frequency_distribution).", + "description": "The frequency distribution assumed for the occurrence of events over a multi-year timeline, from the [frequency_distribution codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#frequency-distribution).", "codelist": "frequency_distribution.csv", "openCodelist": false, "enum": [ @@ -1742,7 +1742,7 @@ "seasonality": { "title": "Seasonality distribution", "type": "string", - "description": "The seasonality distribution assumed for the occurrence of events across a calendar year, from the [seasonality distribution codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#seasonality_distribution)", + "description": "The seasonality distribution assumed for the occurrence of events across a calendar year, from the [seasonality_distribution codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#seasonality-distribution)", "codelist": "seasonality.csv", "openCodelist": false, "enum": [ @@ -1753,7 +1753,7 @@ "calculation_method": { "title": "Calculation Method", "type": "string", - "description": "The methodology used for the calculation of the event set in the modelled scenario(s), taken from the closed [data calculation type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data_calculation_type).", + "description": "The methodology used for the calculation of the event set in the modelled scenario(s), taken from the closed [data_calculation_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data-calculation-type).", "enum": [ "inferred", "observed", @@ -1964,7 +1964,7 @@ }, "dimension": { "title": "Metric dimension", - "description": "The dimension on which the asset's exposure is measured, from the closed [metric dimension codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#metric_dimension).", + "description": "The dimension on which the asset's exposure is measured, from the closed [metric_dimension codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#metric-dimension).", "type": "string", "codelist": "metric_dimension.csv", "openCodelist": false, @@ -1979,7 +1979,7 @@ "quantity_kind": { "title": "Metric quantity kind", "type": "string", - "description": "The kind of quantity by which the exposure is quantified, from the open [quantity kind codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#quantity_kind). If the metric measures a quantity kind that is not included in the codelist, look up the correct code in the [QUDT Quantity Kind Vocabulary](https://www.qudt.org/doc/DOC_VOCAB-QUANTITY-KINDS.html).", + "description": "The kind of quantity by which the exposure is quantified, from the open [quantity_kind codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#quantity-kind). If the metric measures a quantity kind that is not included in the codelist, look up the correct code in the [QUDT Quantity Kind Vocabulary](https://www.qudt.org/doc/DOC_VOCAB-QUANTITY-KINDS.html).", "codelist": "quantity_kind.csv", "openCodelist": true } @@ -2004,7 +2004,7 @@ }, "dimension": { "title": "Cost dimension", - "description": "The dimension of the assets that have incurred the cost, from the closed [metric dimension codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#metric_dimension).", + "description": "The dimension of the assets that have incurred the cost, from the closed [metric_dimension codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#metric-dimension).", "type": "string", "codelist": "metric_dimension.csv", "openCodelist": false, @@ -2382,7 +2382,7 @@ "type": { "title": "Impact type", "type": "string", - "description": "The type of impact calculated, taken from the closed [impact type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact_type).", + "description": "The type of impact calculated, taken from the closed [impact_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact-type).", "codelist": "impact_type.csv", "openCodelist": false, "enum": [ @@ -2394,7 +2394,7 @@ "metric": { "title": "Impact metric", "type": "string", - "description": "The metric used to describe the impact, taken from the open [impact metric codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact_metric).", + "description": "The metric used to describe the impact, taken from the open [impact_metric codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact-metric).", "codelist": "impact_metric.csv", "openCodelist": true, "minLength": 1 @@ -2402,7 +2402,7 @@ "unit": { "title": "Impact unit", "type": "string", - "description": "The unit the impact value is expressed in, taken from the open [impact unit codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact_unit).", + "description": "The unit the impact value is expressed in, taken from the open [impact_unit codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#impact-unit).", "codelist": "impact_unit.csv", "openCodelist": true, "minLength": 1 @@ -2410,7 +2410,7 @@ "base_data_type": { "title": "Impact base data type", "type": "string", - "description": "The type of data used to calculate the impact values, taken from the closed [data calculation type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data_calculation_type).", + "description": "The type of data used to calculate the impact values, taken from the closed [data_calculation_type codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#data-calculation-type).", "codelist": "data_calculation_type.csv", "openCodelist": false, "enum": [ @@ -2429,7 +2429,7 @@ "properties": { "scheme": { "title": "Scheme", - "description": "The scheme or codelist from which the classification code is taken, using the open [classification_scheme](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#classification_scheme) codelist.", + "description": "The scheme or codelist from which the classification code is taken, using the open [classification_scheme](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#classification-scheme) codelist.", "type": "string", "codelist": "classification_scheme.csv", "openCodelist": true, From c7bfbd5fdc63797dd3de4132b57c728e8478b3ca Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 11:13:37 +1200 Subject: [PATCH 06/11] developer_docs.md: Add style guide for codelist field descriptions --- developer_docs.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/developer_docs.md b/developer_docs.md index 6a686bd6..035b05e9 100644 --- a/developer_docs.md +++ b/developer_docs.md @@ -230,6 +230,18 @@ To deploy the `dev` branch to the live documentation site, [create a pull reques ## Style guides +### Schema style guide + +#### Field descriptions + +##### Codelists + +Use the following template, noting that any `_` characters in the codelist title need to be replaced with the `-` character in the codelist URL: + +``` +The , from the [ codelist](https://rdl-standard.readthedocs.io/en/{{version}}/reference/codelists/#codelist-title). +``` + ### Changelog style guide - Use the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format. From b4169bfb7f9c9ba9b82f9b4741a092079f1fbd8b Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 11:15:40 +1200 Subject: [PATCH 07/11] Update changelog --- docs/about/changelog.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/about/changelog.md b/docs/about/changelog.md index af8ab205..d1703d6f 100644 --- a/docs/about/changelog.md +++ b/docs/about/changelog.md @@ -78,6 +78,7 @@ This page lists changes to the Risk Data Library Standard. - [#218](https://github.com/GFDRR/rdl-standard/pull/218) - `Vulnerability·taxonomy` removed from required array. - [#220](https://github.com/GFDRR/rdl-standard/pull/220) - Reorder top-level fields. - [#233](https://github.com/GFDRR/rdl-standard/pull/233) - Rename authorNames to `author_names`, datePublished to `date_published` and gazetteerEntries to `gazetteer_entries`. +- [#236](https://github.com/GFDRR/rdl-standard/pull/236) - Fix broken codelist reference URLs. ### Codelists From 4578c883ab64eb7795821dc532c06b2c57405926 Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 11:55:37 +1200 Subject: [PATCH 08/11] docs/reference/codelists.md: Make tables collapsible --- docs/reference/codelists.md | 318 +++++++++++++++++++++--------------- manage.py | 7 +- 2 files changed, 192 insertions(+), 133 deletions(-) diff --git a/docs/reference/codelists.md b/docs/reference/codelists.md index df9c1c5a..d4a47e53 100644 --- a/docs/reference/codelists.md +++ b/docs/reference/codelists.md @@ -29,13 +29,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/IMT.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/IMT.csv ``` +```` ### classification_scheme @@ -45,13 +45,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/classification_scheme.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/classification_scheme.csv ``` +```` ### damage_scale_name @@ -62,13 +65,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/damage_scale_name.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/damage_scale_name.csv ``` +```` ### data_formats @@ -78,13 +81,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/data_formats.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/data_formats.csv ``` +```` ### engineering_demand_parameter @@ -94,13 +97,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/engineering_demand_parameter.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/engineering_demand_parameter.csv ``` +```` ### impact_metric @@ -110,13 +116,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/impact_metric.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/impact_metric.csv ``` +```` ### impact_unit @@ -126,13 +132,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/impact_unit.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/impact_unit.csv ``` +```` ### license @@ -142,13 +148,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/license.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/license.csv ``` +```` ### location_gazetteers @@ -158,13 +164,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/location_gazetteers.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/location_gazetteers.csv ``` +```` ### media_type @@ -174,13 +183,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/media_type.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/media_type.csv ``` +```` ### quantity_kind @@ -192,13 +201,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/quantity_kind.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/quantity_kind.csv ``` +```` ### roles @@ -210,13 +222,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/open/roles.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/open/roles.csv ``` +```` ## Closed codelists @@ -230,13 +242,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/analysis_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/analysis_type.csv ``` +```` ### country @@ -246,13 +261,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/country.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/country.csv ``` +```` ### currency @@ -262,13 +277,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/currency.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/currency.csv ``` +```` ### data_calculation_type @@ -280,13 +295,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/data_calculation_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/data_calculation_type.csv ``` +```` ### exposure_category @@ -298,13 +316,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/exposure_category.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/exposure_category.csv ``` +```` ### frequency_distribution @@ -314,13 +335,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/frequency_distribution.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/frequency_distribution.csv ``` +```` ### function_approach @@ -334,13 +358,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/function_approach.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/function_approach.csv ``` +```` ### geometry_type @@ -350,13 +377,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/geometry_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/geometry_type.csv ``` +```` ### hazard_type @@ -374,13 +404,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/hazard_type.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/hazard_type.csv ``` +```` ### impact_type @@ -390,13 +420,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/impact_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/impact_type.csv ``` +```` ### loss_type @@ -406,13 +439,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/loss_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/loss_type.csv ``` +```` ### metric_dimension @@ -423,13 +459,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/metric_dimension.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/metric_dimension.csv ``` +```` ### process_type @@ -445,13 +484,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: +````{dropdown} Codes ```{csv-table-no-translate} ---- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/process_type.csv ---- +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/process_type.csv ``` +```` ### relationship_type @@ -464,13 +503,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/relationship_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/relationship_type.csv ``` +```` ### risk_data_type @@ -481,13 +523,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/risk_data_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/risk_data_type.csv ``` +```` ### seasonality @@ -497,13 +542,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/seasonality.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/seasonality.csv ``` +```` ### source_type @@ -513,13 +561,16 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/source_type.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/source_type.csv ``` +```` ### spatial_scale @@ -529,10 +580,13 @@ This codelist is referenced by the following properties: This codelist has the following codes: -```{csv-table-no-translate} +````{dropdown} Codes --- -header-rows: 1 -widths: auto -file: ../../schema/codelists/closed/spatial_scale.csv +open: --- +```{csv-table-no-translate} +:header-rows: 1 +:widths: auto +:file: ../../schema/codelists/closed/spatial_scale.csv ``` +```` diff --git a/manage.py b/manage.py index 93dbcd1d..563ee7d7 100755 --- a/manage.py +++ b/manage.py @@ -155,13 +155,18 @@ def generate_codelist_markdown(codelist, type, references, definitions, defs_pat markdown.append(f"- [`{'/'.join(ref)}`]({url})\n") + newline = "\n" + markdown.extend([ "\nThis codelist has the following codes:\n\n" + "````{dropdown} Codes\n", + f"{f':open:{newline}' if len(read_lines(f'{codelistdir}/{type}/{codelist}.csv')) < 10 else ''}", "```{csv-table-no-translate}\n", ":header-rows: 1\n", ":widths: auto\n", f":file: ../../schema/codelists/{type}/{codelist}.csv\n", - "```\n\n" + "```\n", + "````\n\n" ]) return markdown From 6da0002e88c51af76b66a09b9b8e5a726307c279 Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 11:56:26 +1200 Subject: [PATCH 09/11] schema/codelists/open/classification_scheme.csv: Use consistent separator --- schema/codelists/open/classification_scheme.csv | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/schema/codelists/open/classification_scheme.csv b/schema/codelists/open/classification_scheme.csv index 61f714ff..70cba54a 100644 --- a/schema/codelists/open/classification_scheme.csv +++ b/schema/codelists/open/classification_scheme.csv @@ -1,3 +1,3 @@ Code,Title,Definition,Source,Category GED4ALL-socio-economic,GED4ALL socio-economic taxonomy,The socio-economic taxonomy defined in the Global Exposure Database for Multi-Hazard Risk Analysis (GED4ALL).,https://wiki.openstreetmap.org/wiki/GED4ALL#Socio-Economic,Socio-economic index -MOVER_social_vulnerability_categories,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 +MOVER-social-vulnerability-categories,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 From e5453da72347ebaa175e92e0eb6f1dcb9c91f39c Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Fri, 1 Sep 2023 12:00:48 +1200 Subject: [PATCH 10/11] Update changelog --- docs/about/changelog.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/about/changelog.md b/docs/about/changelog.md index af8ab205..50d980f5 100644 --- a/docs/about/changelog.md +++ b/docs/about/changelog.md @@ -92,6 +92,7 @@ This page lists changes to the Risk Data Library Standard. - [#164](https://github.com/GFDRR/rdl-standard/pull/164) - replace camelCase codes with snake_case codes in 'frequency_distribution.csv' and 'seasonality.csv' - [#189](https://github.com/GFDRR/rdl-standard/pull/189) - add 'ISO 3166-1 alpha-3' to 'location_gazetteers.csv and 'generalized_extreme_value' to 'frequency_distribution.csv' - [#136](https://github.com/GFDRR/rdl-standard/issues/136)- add description for secondary_rupture. +- [#214](https://github.com/GFDRR/rdl-standard/pull/214) - use consistent separators in `classification_scheme.csv` codes. ### Normative documentation @@ -106,6 +107,7 @@ This page lists changes to the Risk Data Library Standard. - [#212](https://github.com/GFDRR/rdl-standard/pull/212) - Update diagrams, add descriptions for dataset, resource and risk components. - [#225](https://github.com/GFDRR/rdl-standard/pull/225) - Update high level descriptions of the 4 risk data components. - [#196](https://github.com/GFDRR/rdl-standard/pull/196) - Add examples to schema reference documentation. +- [#214](https://github.com/GFDRR/rdl-standard/pull/214) - Improve display of codelist reference. ### Non-normative documentation From d0680437b309ccd97a48270ef5ef66e170137dba Mon Sep 17 00:00:00 2001 From: odscjen <95221058+odscjen@users.noreply.github.com> Date: Fri, 1 Sep 2023 09:06:38 +0100 Subject: [PATCH 11/11] Update schema/rdls_schema.json Co-authored-by: Duncan Dewhurst --- schema/rdls_schema.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/schema/rdls_schema.json b/schema/rdls_schema.json index 0bb046fd..b3f53042 100644 --- a/schema/rdls_schema.json +++ b/schema/rdls_schema.json @@ -1816,7 +1816,7 @@ "disaster_identifiers": { "title": "Disaster identifiers", "type": "array", - "description": "Disaster identifiers for this event.", + "description": "Identifiers for the disaster to which this event relates.", "items": { "$ref": "#/$defs/Classification" },