Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Vulnerability adding impact object, function objects and changing some field names and descriptions #124

Merged
merged 31 commits into from
Jul 7, 2023
Merged
Show file tree
Hide file tree
Changes from 27 commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
9b1e2e2
Vulnerability object creation and adding codelists
odscjen Jul 3, 2023
fae501e
delete unused
odscjen Jul 4, 2023
c383762
merge dev
odscjen Jul 4, 2023
77c5170
update impact_metric.csv
odscjen Jul 4, 2023
65038c6
Merge branch 'dev' into vulnerability
odscjen Jul 4, 2023
5e4097b
Merge branch 'dev' into vulnerability
odscjen Jul 4, 2023
d7391d0
update changelog and data_model/codelists and remove unused defs
odscjen Jul 4, 2023
b9ebecf
Apply suggestions from code review
odscjen Jul 6, 2023
d5d613b
fix json and csv errors
odscjen Jul 6, 2023
0550342
merge dev conflicts
odscjen Jul 6, 2023
d5ebac7
Merge branch 'dev' into vulnerability
odscjen Jul 6, 2023
35d5583
address review comments, add lost metrics to impact_metrics.csv and d…
odscjen Jul 6, 2023
f8f5427
move Approach and Relationship back into function objects
odscjen Jul 6, 2023
08527f8
update codelist links to reference from data_model
odscjen Jul 6, 2023
f0d581c
codelists.md: fix merge conflict errors
odscjen Jul 6, 2023
7dbcdcc
fix json error in exposure
odscjen Jul 6, 2023
a5666b0
fix exposure json error, update process list
odscjen Jul 6, 2023
5da0f78
changing exposure and vulnerability anyOf references back to as in #120
odscjen Jul 6, 2023
d3aceda
schema.md: remove broken reference
odscjen Jul 6, 2023
81cb786
update classification_scheme.csv adding definition and category
odscjen Jul 6, 2023
c7eb490
update exposure_category codes
odscjen Jul 6, 2023
fb41e12
fix formatting error in classificatoin_scheme.csv
odscjen Jul 6, 2023
05d2a81
delete unused damage_states_names and damage_scale_names codelists
odscjen Jul 6, 2023
7088673
Apply suggestions from code review
odscjen Jul 7, 2023
8d13794
impact_metric.csv: update duplicate codes to be unique
odscjen Jul 7, 2023
1288ecc
hazard_type.csv: move UNDRRHazardCategoty to end column
odscjen Jul 7, 2023
ed5590d
Update codelists/open/impact_metric.csv
stufraser1 Jul 7, 2023
7eb065b
Update rdl_schema_0.1.json
stufraser1 Jul 7, 2023
1fbe912
impact_metric.csv: add displaced_count and asset_loss codes
odscjen Jul 7, 2023
d77c596
Merge branch 'vulnerability' of github.com:GFDRR/rdl-standard into vu…
odscjen Jul 7, 2023
bd8ff53
Merge branch 'dev' into vulnerability
odscjen Jul 7, 2023
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
4 changes: 4 additions & 0 deletions codelists/closed/analysis_type.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Code,Title,Definition
probabilistic,Probabilistic,Simulation of a large number of synthetic events to estimate their likelihood and severity and estimate overall risk.
deterministic,Deterministic,"Deterministic approaches analyse disaster scenarios (e.g., historical or worst-case events) to estimate their impact, but do not consider the full range of possible outcomes and do not quantify the likelihood of each impact."
empirical,Empirical,"Analysis or data relying on observations, such as hazard intensity recorded during a post-event surveys."
4 changes: 4 additions & 0 deletions codelists/closed/data_calculation_type.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Code,Title,Definition
inferred,Inferred,Original data from during an event.
observed,Observed,Post-event observation data such as post-event damage surveys.
simulated,Simulated,Numerical simulation data.
10 changes: 5 additions & 5 deletions codelists/closed/exposure_category.csv
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Code,Label,Definition
Agriculture,Agriculture,"Agriculture including crops, livestock and agribusiness."
Buildings,Buildings,"Residential, commercial, industrial and public-service buildings such as education, healthcare, governmental buildings, etc."
Infrastructures,Infrastructures,"Lifelines infrastructure, including transport, communications, energy, water."
Population,Population,People.
Natural_environment,Natural environment,"The natural environment, including forestry and other types of vegetation."
agriculture,Agriculture,"Agriculture including crops, livestock and agribusiness."
buildings,Buildings,"Residential, commercial, industrial and public-service buildings such as education, healthcare, governmental buildings, etc."
infrastructure,Infrastructure,"Lifelines infrastructure, including transport, communications, energy, water."
population,Population,People.
stufraser1 marked this conversation as resolved.
Show resolved Hide resolved
natural_environment,Natural environment,"The natural environment, including forestry and other types of vegetation."
24 changes: 12 additions & 12 deletions codelists/closed/hazard_type.csv
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
UNDRRHazardCategory,Code,Title,Description
Meteorological and hydrological,coastal_flood,Coastal Flood,"Inundation of water from the sea into coastal areas, coastal flooding is most frequently the result of storm surges and high winds coinciding with high tides."
Meteorological and hydrological,convective_storm,Convective Storm,"Convective storms or thunderstorms, are severe local storms formed through the process of convection, whereby heat and moisture are transported vertically in the atmosphere. They are associated with thunder, lightning, heavy rain, hail, strong winds and sudden temperature changes. They can occur all year round but are most common during summer (RMETS, 2020)."
Meteorological and hydrological,drought,Drought,"A drought is a period of abnormally dry weather characterised by a prolonged deficiency of precipitation below a certain threshold over a large area and a period longer than a month (WMO, 2020)."
Meteorological and hydrological,extreme_temperature,Extreme Temperature,"Temperature extremes including extreme heat and cold, referred to as heat waves and cold waves."
Meteorological and hydrological,flood,Flood,"Inundation of water as a result of rainfall ponding on the surface and/or originating from river channels, includes pluvial flood and fluvial flood."
Meteorological and hydrological,wildfire,Wildfire,"An unplanned or uncontrolled fire affecting natural, cultural, industrial and residential landscapes (adapted from FAO, 2010)."
Meteorological and hydrological,strong_wind,Strong Wind,"Storms in which high wind speeds and wind forces contribute to damage, including tropical storms and cyclone, extra-tropical cyclone, and tornado."
Geohazards,earthquake,Earthquake,"A sudden slip on a fault, and the resulting ground shaking and radiated seismic energy caused by the slip, volcanic or magmatic activity, or other sudden stress changes in the Earth (USGS, no date)."
Geohazards,landslide,Landslide,"The downslope movement of soil, rock and organic materials under the effects of gravity. Includes various sub-types of landslide including rockfall and mudflows."
Geohazards,tsunami,Tsunami,"A series of travelling waves of extremely long length and period, usually generated by ground movement in earthquakes but also caused by landslides, volcanic eruption and meteorological pressure."
Geohazards,volcanic,Volcanic,"Any potentially dangerous volcanic process that puts human lives, livelihoods or infrastructure at risk of harm. Several hazards may affect the area around the volcano, such as lava flows, pyroclastic flows, lahars, jökulhlaups and landslides or debris avalanches with tephra fall, including ashfall further afield (adapted from BGS, 2012)."
Code,Title,Description,UNDRRHazardCategory
coastal_flood,Coastal Flood,"Inundation of water from the sea into coastal areas, coastal flooding is most frequently the result of storm surges and high winds coinciding with high tides.",Meteorological and hydrological
convective_storm,Convective Storm,"Convective storms or thunderstorms, are severe local storms formed through the process of convection, whereby heat and moisture are transported vertically in the atmosphere. They are associated with thunder, lightning, heavy rain, hail, strong winds and sudden temperature changes. They can occur all year round but are most common during summer (RMETS, 2020).",Meteorological and hydrological
drought,Drought,"A drought is a period of abnormally dry weather characterised by a prolonged deficiency of precipitation below a certain threshold over a large area and a period longer than a month (WMO, 2020).",Meteorological and hydrological
extreme_temperature,Extreme Temperature,"Temperature extremes including extreme heat and cold, referred to as heat waves and cold waves.",Meteorological and hydrological
flood,Flood,"Inundation of water as a result of rainfall ponding on the surface and/or originating from river channels, includes pluvial flood and fluvial flood.",Meteorological and hydrological
wildfire,Wildfire,"An unplanned or uncontrolled fire affecting natural, cultural, industrial and residential landscapes (adapted from FAO, 2010).",Meteorological and hydrological
strong_wind,Strong Wind,"Storms in which high wind speeds and wind forces contribute to damage, including tropical storms and cyclone, extra-tropical cyclone, and tornado.",Meteorological and hydrological
earthquake,Earthquake,"A sudden slip on a fault, and the resulting ground shaking and radiated seismic energy caused by the slip, volcanic or magmatic activity, or other sudden stress changes in the Earth (USGS, no date).",Geohazards
landslide,Landslide,"The downslope movement of soil, rock and organic materials under the effects of gravity. Includes various sub-types of landslide including rockfall and mudflows.",Geohazards
tsunami,Tsunami,"A series of travelling waves of extremely long length and period, usually generated by ground movement in earthquakes but also caused by landslides, volcanic eruption and meteorological pressure.",Geohazards
volcanic,Volcanic,"Any potentially dangerous volcanic process that puts human lives, livelihoods or infrastructure at risk of harm. Several hazards may affect the area around the volcano, such as lava flows, pyroclastic flows, lahars, jökulhlaups and landslides or debris avalanches with tephra fall, including ashfall further afield (adapted from BGS, 2012).",Geohazards
4 changes: 4 additions & 0 deletions codelists/closed/impact_type.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Code,Title,Definition
direct,Direct,The physical or structural impact caused by the disaster such as the destruction of infrastructure caused by the force of physical processes in an event.
indirect,Indirect,"Subsequent or secondary results of the initial damage or destruction, such as business interruption losses. Indirect losses may be incurred far away from the original affected area or later in time."
total,Total,Combination of direct and indirect losses or impact.
60 changes: 31 additions & 29 deletions codelists/closed/process_type.csv
Original file line number Diff line number Diff line change
@@ -1,29 +1,31 @@
Code,Title
FCF,Coastal Flood
FSS,Storm Surge
TOR,Tornado
DTA,Agricultural Drought
DTH,Hydrological Drought
DTM,Meteorological Drought
DTS,Socio-economic Drought
Q1R,Primary Rupture
Q2R,Secondary Rupture
QGM,Ground Motion
QLI,Liquefaction
ECD,Extreme cold
EHT,Extreme heat
FFF,Fluvial Flood
FPF,Pluvial Flood
LAV,Snow Avalanche
LSL,Landslide (general)
TSI,Tsunami
VAF,Ashfall
VBL,Ballistics
VFH,Proximal hazards
VLH,Lahar
VLV,Lava
VPF,Pyroclastic Flow
WFI,Wildfire
ETC,Extratropical cyclone
TCY,Tropical cyclone
MHC,Multi-Hazard combined
Code,Title,Definition
coastal_flood,Coastal Flood,"Most frequently the result of storm surges and high winds coinciding with high tides. The surge itself is the result of the raising of sea levels due to low atmospheric pressure. In particular configurations, such as major estuaries or confined sea areas, the piling up of water is amplified by a combination of the shallowing of the seabed and retarding of return flow (WMO, 2011)."
storm_surge,Storm Surge,"Reflects the difference between the actual water level under the influence of a meteorological disturbance (storm tide) and the level which would have occurred in the absence of the meteorological disturbance (i.e., astronomical tide) (WMO, 2008, 2011, 2017)."
tornado,Tornado,"A rotating column of air, extending from the base of a cumuliform cloud, and often visible as a condensation funnel in contact with the ground, and/or attendant circulating dust or debris cloud at the ground (WMO, 2017)."
agricultural_drought,Agricultural Drought,"Occurs when agricultural production becomes affected. It focuses on precipitation shortages, differences between actual evapotranspiration, soil water deficits, reduced groundwater and so on."
hydrological_drought,Hydrological Drought,Occurs when low water supply becomes evident and is associated with the effects of periods of precipitation shortfalls on surface or subsurface water supply.
meteorological_drought,Meteorological Drought,Occurs when dry weather patterns dominate an area. It is defined usually on the basis of the degree of dryness and the duration of the dry period.
socioeconomic_drought,Socio-economic Drought,"Relates the supply and demand of some economic goods with elements of meteorological, hydrological, and agricultural drought. It also occurs when the demand for an economic good exceeds supply as a result of a weather-related shortfall in water supply."
primary_rupture,Primary Rupture,"Earthquake surface ruptures and fissures are localised ground displacements that develop during and immediately after an earthquake. Surface ruptures represent the upward continuation of fault slip at depth, while fissures are smaller displacements, or more distributed deformation in and around the rupture area."
secondary_rupture,Secondary Rupture,TBA
ground_motion,Ground Motion,Earthquake ground shaking is the movement of the Earth's surface produced by seismic waves that are generated when an earthquake occurs.
liquefaction,Liquefaction,"Soil liquefaction occurs when soil is transformed from a solid to a liquid state as a result of increased pore pressure and reduced effective stress. It is typically caused by rapid loading of the soil during earthquake shaking (AGI, 2017)."
extreme_cold,Extreme cold,"A period of marked and unusual cold weather characterised by a sharp and significant drop in air temperatures near the surface (maximum, minimum and daily average) over a large area and persisting below certain thresholds for at least two consecutive days during the cold season (WMO, 2020)."
extreme_heat,Extreme heat,"A marked unusual period of hot weather over a region persisting for at least two consecutive days during the hot period of the year based on local climatological conditions, with thermal conditions recorded above given thresholds (WMO, 2020)."
fluvial_flood,Fluvial Flood,"A rise, usually brief, in the water level of a stream or water body to a peak from which the water level recedes at a slower rate (WMO, 2012)."
pluvial_flood,Pluvial Flood,"Pluvial flood, or surface water flooding, is caused by rain remaining and ponding on the ground surface during and after rainfall events, and can also include urban flooding, which results form the capacity of urban drainage systems being exceeded."
groundwater_flood,Groundwater Flood,"The emergence of groundwater at the ground surface away from perennial river channels or the rising of groundwater into man-made ground, under conditions where the 'normal' ranges of groundwater level and groundwater flow are exceeded (BGS, 2010)."
snow_avalanche,Snow Avalanche,"A mass of snow and ice falling suddenly down a mountain slope and often taking with it earth, rocks and rubble of every description (WMO, 1992)."
landslide_general,Landslide (general),"The downslope movement of soil, rock and organic materials under the effects of gravity, often triggered by seismic activity or precipitation. This general code can be used to include multiple specific types of landslide activity"
landslide_rockslide,Rockslide,"A movement of a mass of soil or rock on an individualized failure surface (Dennis and Didier, 2019)."
landslide_mudflow,Mudflow,"A flow of water so heavily charged with sediment and debris that the flowing mass is thick and viscous (WMO and UNESCO, 2012)."
landslide_rockfall,Rockfall,"A fragment of rock (a block) detached by sliding, toppling, or falling, that falls along a vertical or sub-vertical cliff."
tsunami,Tsunami,"A series of travelling waves of extremely long length and period, usually generated by disturbances associated with earthquakes occurring below or near the ocean floor, but can also be caused by landslides (subaerial and submarine), volcanic activity and meteorological conditions."
ashfall,Ashfall,"The finest particles of tephra (less than 2 mm diameter) - tephra is a collective term for fragmented magma and old (i.e., preexisting) rocks ejected into the atmosphere from volcanic vents during an explosive eruption."
volcano_balllistics,Ballistics,"Fragments of magma and old (i.e., pre-existing) rocks ejected during an explosive eruption."
lahar,Lahar,"Discrete, rapid, gravity-driven, water-saturated flows containing water and solid particles of volcanic rock, sediment, ice, wood, and other debris that originate at volcanoes."
lava,Lava,"A lava flow forms during an eruption or eruptive episode and travels away from the source vent as fluid, relatively low-viscosity molten rock."
pyroclastic_flow,Pyroclastic Flow,"Also known as pyroclastic density currents these are hot, fast-moving mixtures of volcanic particles and gas that originate from the gravitational collapse of explosive eruption columns, lava domes or lava-flow fronts, and from explosive lateral blasts."
wildfire,Wildfire,"An unplanned or uncontrolled fire affecting natural, cultural, industrial and residential landscapes (UNDRR adapted from FAO, 2010)."
extratropical_cyclone,Extratropical cyclone,"A low-pressure system which develops in latitudes outside the tropics (WMO, 1992)."
tropical_cyclone,Tropical cyclone,"A warm-core, non-frontal synoptic-scale cyclone, originating over tropical or subtropical waters, with organised deep convection and closed surface wind circulation about a well-defined centre (WMO, 2017)."
4 changes: 4 additions & 0 deletions codelists/closed/relationship_type.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Code,Title,Definition
math_parametric,Mathematical function (parametric),"A relationship between structural parameters and expected damage, often based on probabilistic models, such as log-normal or beta distribution. They can account for uncertainties and variability in both the seismic hazard and building attributes."
math_bespoke,Mathematical function (bespoke),"A customized or tailored mathematical function that expresses the relationship between the characteristics of a particular type of structure and its vulnerability to hazard, derived through detailed analysis of that structural type."
discrete,Discrete values,"A function that assigns discrete damage states to specific ranges or categories of parameters, such as construction material, structural system or building age. Each range or category is associated with a probability of exceeding a particular damage state."
5 changes: 5 additions & 0 deletions codelists/closed/spatial_scale.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
Code,Title,Definition
global,Global,The entire world.
regional,Regional,"A supranational region, e.g. Africa."
national,National,A country.
sub-national,Sub-national,A sub-national administrative division.
3 changes: 3 additions & 0 deletions codelists/open/classification_scheme.csv
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This does not seem comprehensive. Why do we not have GED4ALL taxonomy for buildings referenced here, for example?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So at the moment the only place this codelist is being referenced is in se_category so we only included the schemes for that

Original file line number Diff line number Diff line change
@@ -0,0 +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
14 changes: 14 additions & 0 deletions codelists/open/damage_scale_name.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
Code,Title,Definition
EMS-98,EMS-98 (Grünthal 1998),"Scale for earthquake hazard, RC and Masonry construction, with 5 damage states."
HAZUS-MH_MR4,HAZUS-MH MR4 (FEMA 2003),"Scale for earthquake hazard, US building types, with 5 damage states."
Vision_2000,Vision 2000 (SEAOC 1995),"Scale for earthquake hazard, RC and Masonry construction, with 5 damage states."
FEMA_356,FEMA 356 (FEMA 2000),"Scale for earthquake hazard, RC and Masonry construction, with 4 damage states."
Milutinovic_Trendafiloski_2003,Milutinovic and Trendafiloski (2003),"Scale for earthquake hazard, RC and Masonry construction, with 6 damage states."
Blong_2003,Blong (2003),"Scale for earthquake hazard, RC and Masonry construction, with 6 damage states."
HRC,HRC (Rossetto and Elnashai 2003),"Scale for earthquake hazard, RC construction, with 7 damage states."
Crowley_2004,Crowley et al (2004),"Scale for earthquake and landslide hazards, RC construction, with 4 damage states."
Lang_Bachmann_2004,Lang and Bachmann (2004),"Scale for earthquake and landslide hazards, masonry construction, with 6 damage states."
GNDT_2010,GNDT 2010,"Scale for earthquake hazard, Italian building types, with 4 damage states."
JapanCO_2013,Japan Cabinet Office (2013),"Scale for tsunami hazard, RC masonry and timber construction, with 6 damage states."
EEFIT_2006,EEFIT (2006),"Scale for tsunami hazard, RC construction, with 5 damage states."
Fraser_2013,Fraser et al. (2013),"Scale for tsunami hazard, RC masonry and timber construction, with 5 damage states."
7 changes: 7 additions & 0 deletions codelists/open/engineering_demand_parameter.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Code,Title,Definition
PA_dmg_index,Park-Ang damage index,"The Park-Ang damage index (Park et al., 1987) accounts for the effect of maximum deformation and cyclic loads."
peak_floor_acc,Peak floor acceleration,The maximum acceleration at any floor within a structure during an earthquake.
roof_drift,Roof drift ratio,The ratio of the peak lateral roof displacement to the building height.
max_interstorey_drift_ratio,Maximum inter-storey drift ratio,The maximum interstorey drift ratio across all floors.
interstorey_drift_ratio_i,Interstorey drift ratio for storey i,"The peak (over time) interstorey drift ratio, and is calculated as the largest difference between the lateral displacements of two adjacent floors, divided by the height of the storey."
demand_capacity_ratio,Demand to capacity ratio,The ratio between the external actions applied to the structure (demand) over the ability of the structure to carry the imposed actions (capacity). A D/C ratio >1 indicates failure.
Loading