Permalink
Browse files

Merge branch 'master' of github.com:AIFDR/inasafe

  • Loading branch information...
2 parents 5b322d1 + c6c9b26 commit 2f906a3613d86c902690a6cdb9b4bc065d895456 @uniomni uniomni committed Mar 12, 2013
@@ -4,5 +4,10 @@
<option name="myLocal" value="false" />
<inspection_tool class="PyDocstringInspection" enabled="false" level="ERROR" enabled_by_default="false" />
<inspection_tool class="PyPep8Inspection" enabled="true" level="ERROR" enabled_by_default="true" />
+ <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
+ <option name="processCode" value="true" />
+ <option name="processLiterals" value="true" />
+ <option name="processComments" value="true" />
+ </inspection_tool>
</profile>
</component>
@@ -4,11 +4,23 @@ Earthquake Building Impact Function
Overview
--------
-**Unique Identifier**: Earthquake Building Impact Function
+**Unique Identifier**:
+Earthquake Building Impact Function
-**Title**: Be affected
+**Title**:
+Be affected
Details
-------
-No documentation found
+No documentation found
+
+Doc String
+----------
+
+Earthquake impact on building data
+
+ :param requires category=='hazard' and subcategory=='earthquake'
+
+ :param requires category=='exposure' and subcategory=='structure' and layertype=='vector'
+
@@ -4,27 +4,50 @@ Flood Building Impact Function
Overview
--------
-**Unique Identifier**: Flood Building Impact Function
+**Unique Identifier**:
+Flood Building Impact Function
-**Author**: Ole Nielsen, Kristy van Putten
+**Author**:
+Ole Nielsen, Kristy van Putten
-**Rating**: 0
+**Rating**:
+0
-**Title**: Be flooded
+**Title**:
+Be flooded
-**Synopsis**: To assess the impacts of (flood or tsunami) inundation on building footprints originating from OpenStreetMap (OSM).
+**Synopsis**:
+To assess the impacts of (flood or tsunami) inundation on building footprints originating from OpenStreetMap (OSM).
-**Actions**: Provide details about where critical infrastructure might be flooded
+**Actions**:
+Provide details about where critical infrastructure might be flooded
-**Hazard Input**: A hazard raster layer where each cell represents flood depth (in meters), or a vector polygon layer where each polygon represents an inundated area. In the latter case, the following attributes are recognised (in order): "affected" (True or False) or "FLOODPRONE" (Yes or No). (True may be represented as 1, False as 0
+**Hazard Input**:
+A hazard raster layer where each cell represents flood depth (in meters), or a vector polygon layer where each polygon represents an inundated area. In the latter case, the following attributes are recognised (in order): "affected" (True or False) or "FLOODPRONE" (Yes or No). (True may be represented as 1, False as 0
-**Exposure Input**: Vector polygon layer extracted from OSM where each polygon represents the footprint of a building.
+**Exposure Input**:
+Vector polygon layer extracted from OSM where each polygon represents the footprint of a building.
-**Output**: Vector layer contains building is estimated to be flooded and the breakdown of the building by type.
+**Output**:
+Vector layer contains building is estimated to be flooded and the breakdown of the building by type.
-**Limitation**: This function only flags buildings as impacted or not either based on a fixed threshold in case of raster hazard or the the attributes mentioned under input in case of vector hazard.
+**Limitation**:
+This function only flags buildings as impacted or not either based on a fixed threshold in case of raster hazard or the the attributes mentioned under input in case of vector hazard.
Details
-------
-The inundation status is calculated for each building (using the centroid if it is a polygon) based on the hazard levels provided. if the hazard is given as a raster a threshold of 1 meter is used. This is configurable through the InaSAFE interface. If the hazard is given as a vector polygon layer buildings are considered to be impacted depending on the value of hazard attributes (in order) "affected" or "FLOODPRONE": If a building is in a region that has attribute "affected" set to True (or 1) it is impacted. If attribute "affected" does not exist but "FLOODPRONE" does, then the building is considered impacted if "FLOODPRONE" is "yes". If neither "affected" nor "FLOODPRONE" is available, a building will be impacted if it belongs to any polygon. The latter behaviour is implemented through the attribute "inapolygon" which is automatically assigned.
+The inundation status is calculated for each building (using the centroid if it is a polygon) based on the hazard levels provided. if the hazard is given as a raster a threshold of 1 meter is used. This is configurable through the InaSAFE interface. If the hazard is given as a vector polygon layer buildings are considered to be impacted depending on the value of hazard attributes (in order) "affected" or "FLOODPRONE": If a building is in a region that has attribute "affected" set to True (or 1) it is impacted. If attribute "affected" does not exist but "FLOODPRONE" does, then the building is considered impacted if "FLOODPRONE" is "yes". If neither "affected" nor "FLOODPRONE" is available, a building will be impacted if it belongs to any polygon. The latter behaviour is implemented through the attribute "inapolygon" which is automatically assigned.
+
+Doc String
+----------
+
+Inundation impact on building data
+
+ :author Ole Nielsen, Kristy van Putten
+ # this rating below is only for testing a function, not the real one
+ :rating 0
+ :param requires category=='hazard' and subcategory in ['flood', 'tsunami']
+
+ :param requires category=='exposure' and subcategory=='structure' and layertype=='vector'
+
@@ -4,27 +4,49 @@ Flood Evacuation Function
Overview
--------
-**Unique Identifier**: Flood Evacuation Function
+**Unique Identifier**:
+Flood Evacuation Function
-**Author**: AIFDR
+**Author**:
+AIFDR
-**Rating**: 4
+**Rating**:
+4
-**Title**: Need evacuation
+**Title**:
+Need evacuation
-**Synopsis**: To assess the impacts of (flood or tsunami) inundation in raster format on population.
+**Synopsis**:
+To assess the impacts of (flood or tsunami) inundation in raster format on population.
-**Actions**: Provide details about how many people would likely need to be evacuated, where they are located and what resources would be required to support them.
+**Actions**:
+Provide details about how many people would likely need to be evacuated, where they are located and what resources would be required to support them.
-**Hazard Input**: A hazard raster layer where each cell represents flood depth (in meters).
+**Hazard Input**:
+A hazard raster layer where each cell represents flood depth (in meters).
-**Exposure Input**: An exposure raster layer where each cell represent population count.
+**Exposure Input**:
+An exposure raster layer where each cell represent population count.
-**Output**: Raster layer contains population affected and the minimumneeds based on the population affected.
+**Output**:
+Raster layer contains population affected and the minimumneeds based on the population affected.
-**Limitation**: The default threshold of 1 meter was selected based on consensus, not hard evidence.
+**Limitation**:
+The default threshold of 1 meter was selected based on consensus, not hard evidence.
Details
-------
-The population subject to inundation exceeding a threshold (default 1m) is calculated and returned as a raster layer.In addition the total number and the required needs in terms of the BNPB (Perka 7) are reported. The threshold can be changed and even contain multiple numbers in which case evacuation and needs are calculated using the largest number with population breakdowns provided for the smaller numbers. The population raster is resampled to the resolution of the hazard raster and is rescaled so that the resampled population counts reflect estimates of population count per resampled cell. The resulting impact layer has the same resolution and reflects population count per cell which are affected by inundation.
+The population subject to inundation exceeding a threshold (default 1m) is calculated and returned as a raster layer.In addition the total number and the required needs in terms of the BNPB (Perka 7) are reported. The threshold can be changed and even contain multiple numbers in which case evacuation and needs are calculated using the largest number with population breakdowns provided for the smaller numbers. The population raster is resampled to the resolution of the hazard raster and is rescaled so that the resampled population counts reflect estimates of population count per resampled cell. The resulting impact layer has the same resolution and reflects population count per cell which are affected by inundation.
+
+Doc String
+----------
+
+Impact function for flood evacuation
+
+ :author AIFDR
+ :rating 4
+ :param requires category=='hazard' and subcategory in ['flood', 'tsunami'] and layertype=='raster' and unit=='m'
+
+ :param requires category=='exposure' and subcategory=='population' and layertype=='raster'
+
@@ -4,25 +4,46 @@ Flood Evacuation Function Vector Hazard
Overview
--------
-**Unique Identifier**: Flood Evacuation Function Vector Hazard
+**Unique Identifier**:
+Flood Evacuation Function Vector Hazard
-**Author**: AIFDR
+**Author**:
+AIFDR
-**Rating**: 4
+**Rating**:
+4
-**Title**: Need evacuation
+**Title**:
+Need evacuation
-**Synopsis**: To assess the impacts of (flood or tsunami) inundation in vector format on population.
+**Synopsis**:
+To assess the impacts of (flood or tsunami) inundation in vector format on population.
-**Actions**: Provide details about how many people would likely need to be evacuated, where they are located and what resources would be required to support them.
+**Actions**:
+Provide details about how many people would likely need to be evacuated, where they are located and what resources would be required to support them.
-**Hazard Input**: A hazard vector layer which has attribute affected the value is either 1 or 0
+**Hazard Input**:
+A hazard vector layer which has attribute affected the value is either 1 or 0
-**Exposure Input**: An exposure raster layer where each cell represent population count.
+**Exposure Input**:
+An exposure raster layer where each cell represent population count.
-**Output**: Vector layer contains population affected and the minimumneeds based on evacuation percentage.
+**Output**:
+Vector layer contains population affected and the minimumneeds based on evacuation percentage.
Details
-------
-The population subject to inundation is determined whether inan area which affected or not. You can also set an evacuationpercentage to calculate how many percent of the total populationaffected to be evacuated. This number will be used to estimateneeds based on BNPB Perka 7/2008 minimum bantuan.
+The population subject to inundation is determined whether inan area which affected or not. You can also set an evacuationpercentage to calculate how many percent of the total populationaffected to be evacuated. This number will be used to estimateneeds based on BNPB Perka 7/2008 minimum bantuan.
+
+Doc String
+----------
+
+Impact function for vector flood evacuation
+
+ :author AIFDR
+ :rating 4
+ :param requires category=='hazard' and subcategory in ['flood', 'tsunami'] and layertype=='vector'
+
+ :param requires category=='exposure' and subcategory=='population' and layertype=='raster'
+
@@ -4,34 +4,39 @@ I T B Fatality Function
Overview
--------
-**Unique Identifier**: I T B Fatality Function
+**Unique Identifier**:
+I T B Fatality Function
-**Author**: Hadi Ghasemi
+**Author**:
+Hadi Ghasemi
-**Rating**: 3
+**Rating**:
+3
-**Title**: Die or be displaced
+**Title**:
+Die or be displaced
-**Synopsis**: To asses the impact of earthquake on population based on earthquake model developed by ITB
+**Synopsis**:
+To asses the impact of earthquake on population based on earthquake model developed by ITB
-**Actions**: Provide details about the population will be die or displaced
+**Actions**:
+Provide details about the population will be die or displaced
**Citations**:
-
-* Indonesian Earthquake Building-Damage and Fatality Models and Post Disaster Survey Guidelines Development Bali, 27-28 February 2012, 54pp.
-* Allen, T. I., Wald, D. J., Earle, P. S., Marano, K. D., Hotovec, A. J., Lin, K., and Hearne, M., 2009. An Atlas of ShakeMaps and population exposure catalog for earthquake loss modeling, Bull. Earthq. Eng. 7, 701-718.
-* Jaiswal, K., and Wald, D., 2010. An empirical model for global earthquake fatality estimation, Earthq. Spectra 26, 1017-1037.
+ * Indonesian Earthquake Building-Damage and Fatality Models and Post Disaster Survey Guidelines Development Bali, 27-28 February 2012, 54pp.
+ * Allen, T. I., Wald, D. J., Earle, P. S., Marano, K. D., Hotovec, A. J., Lin, K., and Hearne, M., 2009. An Atlas of ShakeMaps and population exposure catalog for earthquake loss modeling, Bull. Earthq. Eng. 7, 701-718.
+ * Jaiswal, K., and Wald, D., 2010. An empirical model for global earthquake fatality estimation, Earthq. Spectra 26, 1017-1037.
**Limitation**:
+ - The model is based on limited number of observed fatality rates during 4 past fatal events.
+ - The model clearly over-predicts the fatality rates at intensities higher than VIII.
+ - The model only estimates the expected fatality rate for a given intensity level; however the associated uncertainty for the proposed model is not addressed.
+ - There are few known mistakes in developing the current model:
-* The model is based on limited number of observed fatality rates during 4 past fatal events.
-* The model clearly over-predicts the fatality rates atintensities higher than VIII.
-* The model only estimates the expected fatality rate for a given intensity level; however the associated uncertainty for the proposed model is not addressed.
-* There are few known mistakes in developing the current model:
-- rounding MMI values to the nearest 0.5,
-- Implementing Finite-Fault models of candidate events, and
-- consistency between selected GMPEs with those in use by BMKG.
+ * rounding MMI values to the nearest 0.5,
+ * Implementing Finite-Fault models of candidate events, and
+ * consistency between selected GMPEs with those in use by BMKG.
Details
@@ -40,4 +45,74 @@ Details
This model was developed by Institut Tecknologi Bandung (ITB) and implemented by Dr Hadi Ghasemi, Geoscience Australia
Algorithm:
In this study, the same functional form as Allen (2009) is adopted o express fatality rate as a function of intensity (see Eq. 10 in the report). The Matlab built-in function (fminsearch) for Nelder-Mead algorithm was used to estimate the model parameters. The objective function (L2G norm) that is minimized during the optimisation is the same as the one used by Jaiswal et al. (2010).
-The coefficients used in the indonesian model are x=0.62275231, y=8.03314466, zeta=2.15
+The coefficients used in the indonesian model are x=0.62275231, y=8.03314466, zeta=2.15
+
+Doc String
+----------
+
+Indonesian Earthquake Fatality Model
+
+ This model was developed by Institut Tecknologi Bandung (ITB) and
+ implemented by Dr Hadi Ghasemi, Geoscience Australia
+
+
+ Reference:
+
+ Indonesian Earthquake Building-Damage and Fatality Models and
+ Post Disaster Survey Guidelines Development,
+ Bali, 27-28 February 2012, 54pp.
+
+
+ Algorithm:
+
+ In this study, the same functional form as Allen (2009) is adopted
+ to express fatality rate as a function of intensity (see Eq. 10 in the
+ report). The Matlab built-in function (fminsearch) for Nelder-Mead
+ algorithm was used to estimate the model parameters. The objective
+ function (L2G norm) that is minimised during the optimisation is the
+ same as the one used by Jaiswal et al. (2010).
+
+ The coefficients used in the indonesian model are
+ x=0.62275231, y=8.03314466, zeta=2.15
+
+ Allen, T. I., Wald, D. J., Earle, P. S., Marano, K. D., Hotovec, A. J.,
+ Lin, K., and Hearne, M., 2009. An Atlas of ShakeMaps and population
+ exposure catalog for earthquake loss modeling, Bull. Earthq. Eng. 7,
+ 701-718.
+
+ Jaiswal, K., and Wald, D., 2010. An empirical model for global earthquake
+ fatality estimation, Earthq. Spectra 26, 1017-1037.
+
+
+ Caveats and limitations:
+
+ The current model is the result of the above mentioned workshop and
+ reflects the best available information. However, the current model
+ has a number of issues listed below and is expected to evolve further
+ over time.
+
+ 1 - The model is based on limited number of observed fatality
+ rates during 4 past fatal events.
+ 2 - The model clearly over-predicts the fatality rates at
+ intensities higher than VIII.
+ 3 - The model only estimates the expected fatality rate for a given
+ intensity level; however the associated uncertainty for the proposed
+ model is not addressed.
+ 4 - There are few known mistakes in developing the current model:
+ - rounding MMI values to the nearest 0.5,
+ - Implementing Finite-Fault models of candidate events, and
+ - consistency between selected GMPEs with those in use by BMKG.
+ These issues will be addressed by ITB team in the final report.
+
+ Note: Because of these caveats, decisions should not be made solely on
+ the information presented here and should always be verified by ground
+ truthing and other reliable information sources.
+
+ :author Hadi Ghasemi
+ :rating 3
+
+ :param requires category=='hazard' and subcategory=='earthquake' and layertype=='raster' and unit=='MMI'
+
+ :param requires category=='exposure' and subcategory=='population' and layertype=='raster'
+
+
Oops, something went wrong.

0 comments on commit 2f906a3

Please sign in to comment.