Vulnerability (OpenSHA)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.opensha.sra.vulnerability
Interface Vulnerability

All Known Implementing Classes:: AbstractVulnerability, CCLargeHouseImmediateOccupancy, CCLargeHouseRigidDiaphram, CCLargeHouseTypical, CCLargeHouseWaistWall, CCSmallHouseRetro, CCSmallHouseTypical, CCTownhouseLimitedDrift, CCTownhouseTypical, CureeCaltechWoodFrame, SimpleVulnerability

public interface Vulnerability

This class represents a Vulnerability relationship. A Vulnerability relationship gives the pdf of loss as a function of (scalar) Intensity measure Level (IML). It is associated with one among a predefined set of LossTypes. The Vulnerability relationship for a given Asset must be associated with the same LossType as the Asset. If the Asset is a building, all the possible Vulnerability relationships must give building repair cost normalized by replacement cost. If the Asset is contents, all the possible Vulnerability relationships must give content repair normalized by replacement cost. If the Asset is people, all the possible Vulnerability relationships must give number of people injured normalized by number of occupants. If the Asset is economic output, all the possible Vulnerability relationships must give number of days of lost use.

Four subclasses of vulnerability relationship have been defined:

Damage exceedance matrix. Columns: IMLs; rows: fraction of value lost; cells: probability of exceeding fraction of value lost given IML. Implemented by Martinez.
Damage probability matrix. Columns: IMLs; rows: MECE range of fraction of value lost from 0 to 100%; cells: probability of experiencing fraction of value lost given IML.
Discrete vulnerability function and COV: column 1: IML; column 2: expected value of loss as fraction of value exposed, given IML; column 3: coefficient of variation of loss given IML. Vulnerability function also has a prescribed parametric conditional distribution of loss, given IML.
Parametric vulnerability relationship like Wesson et al. (2004).

Version:: $Id: Vulnerability.java 8315 2011-11-07 21:19:37Z kmilner $
Author:: Keith Porter, Ned Field, Peter Powers
See Also:: Asset, AssetCategory, LossType

Method Summary
`AssetCategory`	`getAssetType()` Returns the `AssetType` for which this `Vulnerability` relationship is applicable.
`double`	`getExceedProb(double loss, double iml)` Returns the probability P of loss L being exceeded given L and IML.
`double[]`	`getIMLValues()` Returns a sorted (ascending) array of discrete IMLs at which the `Vulnerability` relationship is defined.
`String`	`getIMT()` Returns the Intensity Measure Type (IMT) associated with this `Vulnerability` relationship.
`double`	`getLossStdDev()` Returns the standard deviation of loss given a value of IML.
`LossType`	`getLossType()` Returns the `LossType` for which this `Vulnerability` relationship is applicable.
`double`	`getMaxIMLVal()` Returns maximum IML supported by the `Vulnerability` relationship.
`double`	`getMeanDamageAtExceedProb(double iml, double prob)` Returns the mean damage with probability P of being exceeded given P and an IML (in linear space).
`double`	`getMeanDamageFactor(double iml)` Returns the mean damage factor at the given IML in linear space.
`double`	`getMinIMLVal()` Returns minimum IML supported by the `Vulnerability` relationship.
`String`	`getName()` Returns the name of this `Vulnerability` relationship.
`ParameterList`	`getParameters()` Returns the list of adjustable parameters associated with this `Vulnerability` relationship.
`double`	`getPeriod()`
`String`	`getShortName()` Returns the short name of this `Vulnerability` relationship.
`AbstractDiscretizedFunc`	`getVulnerabilityFunc()` Returns the mean value of loss at each IML value.
`void`	`setParameter(String name, Object value)` Sets an adjustable parameter

Method Detail

getName

String getName()

Returns the name of this Vulnerability relationship.

Returns:: the name of this Vulnerability

getShortName

String getShortName()

Returns the short name of this Vulnerability relationship.

Returns:: the short name of this Vulnerability

getParameters

ParameterList getParameters()

Returns the list of adjustable parameters associated with this Vulnerability relationship. These Parameters are implementation specific.

Returns:: the list of adjustable Parameters

setParameter

void setParameter(String name,
                  Object value)

Sets an adjustable parameter

Parameters:: name - of the Parameter to set; value -

getIMLValues

double[] getIMLValues()

Returns a sorted (ascending) array of discrete IMLs at which the Vulnerability relationship is defined.

getMinIMLVal

double getMinIMLVal()

Returns minimum IML supported by the Vulnerability relationship. Nonnegative real.

Returns:: the minimum IML value

getMaxIMLVal

double getMaxIMLVal()

Returns maximum IML supported by the Vulnerability relationship. Nonnegative real. (Can be infinity.)

Returns:: the maximum IML value

getMeanDamageFactor

double getMeanDamageFactor(double iml)

Returns the mean damage factor at the given IML in linear space. Non-negative real (double).

Returns:: the mean loss for a given IML

getLossStdDev

double getLossStdDev()

Returns the standard deviation of loss given a value of IML. Non-negative real (double).

Returns:: the stadard deviation of loss for a given IML

getMeanDamageAtExceedProb

double getMeanDamageAtExceedProb(double iml,
                                 double prob)

Returns the mean damage with probability P of being exceeded given P and an IML (in linear space). Non-negative real (double).

Returns:: the loss for a given probability and IML

getExceedProb

double getExceedProb(double loss,
                     double iml)

Returns the probability P of loss L being exceeded given L and IML. (i.e. the method returns P[LM ??? L|L, IML]). Real between 0 and 1 (double).

Returns:: the probability of a loss being exceeded for a given loss and IML.

getAssetType

AssetCategory getAssetType()

Returns the AssetType for which this

Vulnerability

relationship is applicable.

Returns:: the associated AssetType

getLossType

LossType getLossType()

Returns the LossType for which this

Vulnerability