Schema attributes

The vulnerability schema includes physical fragility and vulnerability relationships in relation to specific hazards or for multi-hazard (combination of individual hazards). A wide range of model types and parameters can describe vulnerability, for this reason there are many possible variables accounted by the Vulnerability schema. But only a part of them will be required to describe one specific model. The schema distinguishes key information describing the vulnerabilirt model, including:

  • function type (i.e fragility, vulnerability, damage-to-loss)
  • countries the function was developed for, measured in terms of to geographic relevance
  • development approach (empirical, analytical, judgement, hybrid, code-based)
  • mathematical model used (including exponential, cumulative lognormal/normal)
  • the intensity measure and asset type the function relates to
  • loss parameter / engineering demand parameter values
classDiagram Model -- Specifics Model -- Additional Model: Hazard type Model: Exposure taxonomy Model: Calculation method class Specifics{ Parameters Damage states Intensity measure } class Additional{ Validation Error Fitness }

The model attributes specify which hazard types and exposure categories the vulnerability relationship applies to. Other attributes describe the function type and the analytical approach adopted, and add notes on the model applicability in terms of location and scale.

Required Attribute Description Type
* Primary hazard Main hazard type from list of options Hazard list
Secondary hazard Secondary hazard type from list of options Hazard list
* Primary process Primary hazard process from list of options Process list
Secondary process Secondary hazard process from list of options Process list
* Frequency Frequency representation type
  • Rate of Exceedence
  • Probability of Exceedence
  • Return Period
* Intensity unit Unit to measure hazard intensity Option list
* Exposure category Frequency representation type
  • Buildings
  • Indicators
  • Infrastructures
  • Crops, livestock and forestry
* Exposure occupancy Type of occupancy to which function applies
  • Residential
  • Commercial
  • Industrial
  • Infrastructure
  • Healthcare
  • Educational
  • Government
  • Crop
  • Livestock
  • Forestry
  • Mixed
Taxonomy source Name of exposure taxonomy Text
Taxonomy code Name of taxonomy Taxonomy code to which function applies
* Impact type Type of impact
  • Direct
  • Indirect
  • Total
* Function type Type of function
  • Fragility
  • Vulnerability
  • Damage-to-Loss
Approach Type of methodological approach
  • Empirical
  • Analytical
  • Judgement
  • Hybrid
* Relationship type Type of relationship
Mathematical model Type of mathematical model
  • Parametric
  • Bespoke
* Scale applicability At which spatial scale the function applies
  • Individual items
  • Aggregated to grid
  • Aggregated to boundaries
  • N/A
* Transferrability List of countries in which the model could be applied ISOa3 code
* Local applicability Specific sub-area within a country or region to wich the model specifically applies Location name
Transferrability notes Details about applicability to different areas Text

The specifics attributes add more optional details.

Field name Description Example
par_names Parameters values names MIDR , Ash depth
ub_par_value Upper bound parameters value (Value1; Value2)
ub_par_perc Upper bound parameters percentiles (Perc1; Perc2)
med_par_value Median parameter values (Med1; Med2)
lb_par_value Lower bound parameters value (Value1; Value2)
lb_par_perc Lower bound parameters percentiles (Perc 1;Perc 2)
damage_scale_code Code that identifies the damage scale
dm_state_name Damage states studied in the reference study of the function
n_dm_states Number of damage states studied in the reference study of the function
f_disc_im Intensity measure values for the characterization of discrete functions
f_disc_ep This field lists the associated exceeded probability values to the IM values of the previous field
edp_code Code related to specific engineering demand parameter (EDP) used to the DS thresholds
edp_name Specific engineering demand parameter (EDP) used to the DS thresholds
edp_dmstate_thre Specific damage state EDP threshold
im_code Code of intensity measure
im_name Name of intensity measure
im_range Range of intensity measures as min;max (e.g. 0;500)
im_units Unit of intensity measure
im_method Type of source of the im data
im_sim_type Type of simulation, Physics-based or IMPE
impe_referenec Reference study of the IMPE simulation
data_countries ISO code(s) of countries to which data refer
im_data_source Reference studies for the IM data sources
n_events Number of events the function has been built on
n_assets INumber of assets the function has been built on

The additional attributes cover more specific information that helps to understand the analysis which generated the function.

Field name Description Example
* nonsampling_err Is there sampling error? NO
type_nonsampling_err Type of non sampling error
is_fix_nonsam_err Has non sampling error being fixed? TRUE
is_data_aggregated Has data been aggregated? FALSE
is_data_disaggr Has data been disaggregated? TRUE
n_data_points_aggr Number of aggregated data points used for the evaluation of data quality 600
an_analysis_type Type of analysis for Analytical functions
em_analysis_type Type of analysis for Empirical functions
jd_analysis_type Type of analysis for Judgement functions
is_fit_good Is the model fitness to data good overall? TRUE
fit_ref Reference model for fitting
val_data_source If validation has been done, source of the independent data
val_study_reference Reference of the Validation study
sample Type of sampling


Need to find some.

Example name