Changelog

This page lists changes to the Risk Data Library Standard.

1.0 - 2026-06-10

Schema

Changes in this section are grouped by the schema component that they affect.

Cross-cutting

Changes in this section affect more than one schema component.

#392, #409 (affects Hazard, Vulnerability and Loss):
- Rationalise hazard modelling
- Add conditional validation of hazard process based on hazard type
- Add conditional validation of intensity measure based on hazard type
- Add Hazard.classification and Classification.title
#380 (affects Exposure, Vulnerability and Loss):
- Metric - Replace .quantity_kind with .measurement.quantity_kind and .measurement.unit
- Impact - Replace .unit with .measurement.quantity_kind and .measurement.unit
#396 (affects Dataset and Hazard):
- Entity: Require any of .email, .url.
- Event.ocurrence: Require any of .probabilistic, .empirical, .deterministic.
#400 (affects Dataset and Loss):
- Move .sources to .lineage.sources
- Add Source.risk_data_type
- Rename Source.component to Source.used_in
- Add .lineage.description
- Remove .hazard_id, .exposure_id and .vulnerability_id from Losses
#407 (affects Dataset and Resource)
- Add temporal and spatial_resolution at dataset level
- Add spatial to Resource
- Update descriptions for spatial, temporal, spatial_resolution and temporal_resolution at both dataset and resource level.
#422 (affects Dataset, Resource, Hazard, Vulnerability and Loss):
- Replace project with project.name and project.url.
- Require either Resource.download_url or Resource.access_url.
- Make SimpleHazard.type and SimpleHazard.process required.
- Align enums with codelist CSVs.
- Remove Location.geometry.
#405 (affects Dataset, Vulnerability and Losses):
- 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

Dataset

#373:
- Add License to $defs
- Add format: iri to License.
- Add field license to source object.
#482:
- Add Affiliation to $defs/Entity
#483:
- Remove Format: iri from $defs/license
- Add Citation to $defs/source
- Add Rights related to license in general attributes and in $defs/source

Resource

#404
- Add Climate object to $defs with fields for model, scenario and percentile
- Add climate to Resource
- Add baseline_period to Resource
- Add central_year to Period
#401 - Add Resource.conforms_to.
#398 - Add spatial_aggregation to Resource.
#484 - Make either .media_type or .format required in Resource.

Hazard

#406 - Remove fields:
- Event.footprint
- Event_set.temporal
- Event_set.spatial
#441 - Update description of .events.
#487 - Solve coastal flood duplication in hazard_type and process_type.
- Remove coastal_flood from hazard_type
- Remove coastal_flood dependency from “coastal_flood” in process_type
- Change storm_surge dependency from “coastal_flood” to “strong_wind” in process_type

Exposure

#408 - Make exposure an array of Exposure_items.
#415 - Replace Exposure_item.taxonomy with Exposure_item.classification.
#434 - Update Exposure_item.asset_type.scheme description.

Vulnerability

#395 - Refactor vulnerability component.

Loss

#402 - Restructure Losses:
- Rename .category to .asset_category
- Move .cost.dimension to .asset_dimension
- Move .impact.type to .impact_and_losses.impact_type
- Move .impact.base_data_type to .impact_and_losses.impact_modelling
- Move .impact_metric to .impact_and_losses.impact_metric
- Replace .impact.unit and .cost.unit with .impact_and_losses.Measurement
- Move .type to .impact_and_losses.loss_type
- Move .approach to .impact_and_losses.loss_approach
- Move .hazard_analysis_type to .losses_and_impact.loss_frequency_type
#453 Added disaster_identifiers to losses

Codelists

Changes in this section are grouped by the codelist that they affect.

classification_scheme.csv:
- Add codes:
  - #409 - ‘UNDRR-HIPS-2025’
  - #395:
    - ‘HAZUS’
    - ‘CDC-SVI’
    - ‘Custom’
    - ‘EMS-98’
    - ‘PAGER’
    - ‘OED’
- Remove codes:
  - #395 - ‘GED4ALL-socio-economic’
  - #434 - ‘USHS_EHP’
- Rename codes:
  - #395 - ‘MOVER-social-vulnerability-categories’ to ‘MOVER’
- #440 - Fix typo in GLIDE category
exposure_category.csv:
- #395 - Add ‘economic_indicator’ and ‘development_index’
hazard_type.csv:
- #409 - Align with UNDRR HIPs.
impact_metric.csv:
- Add codes:
  - #381 - ‘risk_index’
  - #395 - ‘exposure_to_hazard’
  - #402 - ‘production_loss’ and ‘exposure_to_hazard’
  - #418:
    - ‘fatality_ratio_vulnerability’
    - ‘fatality_count’
    - ‘fatality_ratio_loss’
    - ‘disruption_days’
    - ‘disruption_loss’
    - ‘displaced_days’
- Rename codes:
  - #384 - Rename non-unique ‘loss_ratio’ codes
imt.csv:
- Add codes
  - #411 - ‘fl_d:h’
  - #418:
    - ‘POE’
    - ‘DSize’
    - ‘SA:g’
- #370, #383 - Rename codes and update code format
- #409 - Align with UNDRR HIPs
- #453 - Adding imt for sea level rise
- #467 - Replace ‘inundation’ with ‘flow’ for clarity and compatibility with landslide hazard
license.csv:
- #373 - Replace codes with license URLs, update titles
- #440, #453 - Add ‘https://creativecommons.org/licenses/by-nc/4.0/’
metric_dimension.csv:
- #422 - Add missing title and description for ‘index’.
process_type.csv:
- #385 - Add ‘volcano_gas_aerosols’
- #409 - Align with UNDRR HIPs.
quantity_kind.csv:
- #403 - Add ‘index’.
spatial_scale.csv:
- #397 - Add ‘urban’.
impact_metric.csv:
- #488 - Revise ‘impact_metric’ codelist, add new ‘loss_statistic’ closed codelist.
climate_scenario.csv:
- #481 - Add 7 CMIP7 scenarios
unit_currency.csv:
- #486 - Fix date format for currency; add INT -International Dollar (PPP adjusted); add valuation_year related to unit_currency.csv
taxonomy_ged4all.csv:
- #485 - Add codelist to support inclusion of id codes for classification scheme = GED4ALL.

Normative documentation

#405 - Restructure schema reference documentation.
#460 - Minor edits to reference documentation.
#461 - Minor edits to reference documentation.

Non-normative documentation

#427 - Add worked examples, update overview and how-to guides for publishing RDLS metadata.
#429 - Add guidance on describing location-only exposure data.
#433 - Update How do I implement the RDLS?.
#431 - Update What is the RDLS?.
#434 - Remove guides/metadata/mappings.md in favour of mappings documented in codelists.
#452 - Update examples in reference documentation.
#460 - Minor edits to documentation.

0.2.0 - 2023-09-08

Schema

#93 - Remove nesting in top-level object.
#101 - create Exposure object and updated associated field names, titles and descriptions.
#105 - Create Spatial object, replacing common.geo_coverage.
#102 - Replace resource object with Resource definition, add Resource.id and update the names, titles and descriptions of its other properties.
#104 - Add Period object.
#100 - Update field names, titles and descriptions not covered in other issues.
#119:
- Add fields:
  - identifier
  - sources
  - temporal_resolution
  - Resource.temporal_resolution
- Add Source definition.
- Update field descriptions in Resource definition.
- Add validation keywords to Location, Gazetteer_entry and Geometry definitions.
#116 - Replace biblio_title and biblio_url with Related_resource definition.
#115 - Add Entity and Attribution objects, update entity related field names and descriptions.
#121:
- Nest footprints within events and events within event sets.
- Update calculation_method.
- Add fields:
  - event_set.id
  - event.id
  - footprint_set.id
  - event_set.disaster_identifier
  - event_set.frequency_distribution
  - event_set.seasonality
  - event_set.calculation_method
  - event_set.number_events
  - event_set.temporal
- Add codelists for event_set.hazard_type and event_set.analysis_type.
- Move process_type from footprint_set to event and event_set.
- Create Occurrence object.
- Removes common_calc_method, common_frequency_type, common_hazard_type, common_impact_type, common_process_type and im_code.
#124:
- Replace vulnerability object with Vulnerability definition.
- Replace function_type, calculation_method, approach, f_math and f_relationship with functions object and Vulnerability_function, Fragility_function, Damage_to_loss_function and Engineering_demand_function definitions.
- Add .scale to Spatial object.
- Update field names, titles and descriptions in Vulnerability definition.
- Create Impact object and update associated field names, titles and descriptions. -#132:
- Replace loss object with Loss definition.
- Removes time_start, time_end, time_year from loss.
- Removes loss_loss_type, loss_metric from $defs.
#127 - Inline Exposure, Hazard_metadata, vulnerability, Vulnerability_function, Fragility_function, Occurence, Damage_to_loss_function, Engineering_demand_function, Probability, Empirical, Deterministic and Loss and rearrange $defs.
#168 - Add version number and links field.
#163 - fix typos within rdl_schema_0.1.json
#180 - Refactors schema, moves hazard, exposure, vulnerability and loss to top level and removes ‘anyOf’.
#181 - Various fixes:
- Codelist filename in Classification.scheme
- {{version}} placeholder replacement in built schema
- version type
- Required fields in Event_set, Hazard and Footprint
- Markdown syntax in Attribution.role description
#190 - Deletes type key from properties with $ref components.
#212 - Update top-level description.
#203, #228 - Add package schema.
#204, #229:
- Add field metrics.
- rename cost_type.csv to metric_dimension.csv and update code descriptions.
- Add quantity_kind.csv.
#207:
- update description of spatial to recommend use of bbox when coordinates based location is needed.
- update descriptions of spatial, bbox, centroid and coordinates to specify use of WGS84 and decimal degrees.
- update coordinates to allow only numbers within arrays.
#208 - Add regex pattern to coordinate_system and update description to mandate ESRI or EPSG codes.
#205 - Convert risk_data_type to array.
#215 - Remove .hazard_id, exposure_id and vulnerability_id from loss required array.
#210 - Replace resource.url with .access_url and download_url
#218 - Vulnerability·taxonomy removed from required array.
#220 - Reorder top-level fields.
#233, #235 - Rename authorNames to author_names, datePublished to date_published and gazetteerEntries to gazetteer_entries.
#232
- Convert disaster_identifiers to array of Classification objects.
- Add new codes to classification_scheme.csv.
#236, #244 - Fix broken codelist reference URLs.
#239 - Clarify purpose of links, add link to dataset identifier guidance in id description.
#241 - Update schema and documentation URLs.
#242 - Remove redundant minProperties keywords, add missing minLength and uniqueItems keywords.
#246 - Update loss component:
- Replace loss object with loss.losses array.
- Replace loss.costs array with loss.losses.cost object.

Codelists

#101 - Update and rename cost_type.csv and create exposure_category.csv.
#114 - ‘IMT.csv’ add descriptions and change pattern of codes to metric:unit.
#117 - Create ‘license.csv’ codelist and replace license_code field with license.
#105 - Create ‘country.csv’, ‘location_gazetteers.csv’ and ‘geometry_type.csv’.
#121 - Create ‘frequency_distribution.csv’ and ‘seasonality.csv’
#130 - ‘hazard_type.csv’ add descriptions and hazard category which aligns with UNDRR Hazard taxonomy, and update codes from abbreviations to human-readable words.
#134 - ‘risk_data_type.csv’, replace codes with lower-case versions.
#143 - Update ‘license.csv’ to include Open Definition conformant licences and those listed as options on WB Data Catalog.
#164 - replace camelCase codes with snake_case codes in ‘frequency_distribution.csv’ and ‘seasonality.csv’
#189 - add ‘ISO 3166-1 alpha-3’ to ‘location_gazetteers.csv and ‘generalized_extreme_value’ to ‘frequency_distribution.csv’
#136- add description for secondary_rupture.
#214 - use consistent separators in classification_scheme.csv codes.
#459 - update currency codelist with current and historic ISO 4217 codes, update manage.py to automate this process.

Normative documentation

#120:
- Rename data model documentation to reference documentation.
- Use jsonschema Sphinx directive to generate schema reference tables from schema.
- Restructure reference documentation.
- Update manage.py pre-commmit to generate sub-schema reference.
#169 - Uncollapse event_sets in hazard reference table.
#146 - Update introduction to the RDLS reference section.
#193 - Fix lists of referencing fields for subschemas and codelists.
#212 - Update diagrams, add descriptions for dataset, resource and risk components.
#225 - Update high level descriptions of the 4 risk data components.
#196 - Add examples to schema reference documentation.
#214 - Improve display of codelist reference.

Non-normative documentation

#111 - Add Global Library for Schools Infrastructure (GLOSI) to taxonomies.
#171 - Updating glossary to add loss components, adjust other entries and remove images from glossary.
#174 - Add local tests guidance to developer_docs.md
#172 - Re-write use cases as user stories, for data publisher and data user roles.
#175 - Restructure documentation, rewrite landing page, add new introductory content.
#224 - Update contact email addresses.
#239 - Add content to docs/guides/metadata.md, add UNDRR-ISC HIP taxonomy mapping.
#243 - Add link to RDLS Convertor tool in navigation menu.