wntr.scenario.earthquake module

The wntr.scenario.earthquake module includes methods to define an earthquake location, magnitude and depth, and compute PGA, PGV, and repair rate.

class wntr.scenario.earthquake.Earthquake(epicenter, magnitude, depth)

Bases: object

Earthquake scenario class.

Methods

DTGR(M, M_min, M_max, b)	Returns the the Doubly Truncated Gutenberg Richter cumulative probability for the specified magnitude, magnitude range, and coefficient.
DTGR_inv(P, M_min, M_max, b)	Returns the inverse of the Doubly Truncated Gutenberg Richter distribution for the specified probability, magnitude range, and coefficient.
correction_factor(pipe_characteristics[, …])	Correction factor Defaults based on Isoyama et al., 2000
distance_to_epicenter(wn[, element_type])	Distance to the epicenter
pga_attenuation_model(R[, method])	Peak ground acceleration attenuation models
pgv_attenuation_model(R[, method])	Peak ground velocity attenuation models
repair_rate_model(PGV[, C, method])	Calculate repair rate

epicenter = None

Earthquake epicenter, (x,y) tuple in meters

magnitude = None

Earthquake magnitude, Richter scale

depth = None

Earthquake depth, m

distance_to_epicenter(wn, element_type=<class 'wntr.network.base.Node'>)

Distance to the epicenter

Parameters:

wn : WaterNetworkModel

element_type: optional (default = wntr.network.Node)

Returns:

R : pd.Series

Distance to epicenter (m)

pga_attenuation_model(R, method=None)

Peak ground acceleration attenuation models

Parameters:

R : pd.Series

Distance to epicenter (m)

method : int (optional, default = None, average)

1 = Kawashima et al. (1984) 2 = Baag et al. (1998) 3 = Lee and Cho (2002)

Returns:

PGA : pd.Series

Peak ground acceleration (g)

pgv_attenuation_model(R, method=None)

Peak ground velocity attenuation models

Parameters:

R : pd.Series

Distance to epicenter (m)

method : int (optional, default = None, average)

1 = Yu and Jin (2008) - Rock 2 = Yu and Jin (2008) - Soil

Returns:

PGV : pd.Series

Peak ground velocity (m/s)

correction_factor(pipe_characteristics, diameter_weight=None, material_weight=None, topography_weight=None, liquifaction_weight=None)

Correction factor Defaults based on Isoyama et al., 2000

repair_rate_model(PGV, C=1, method=1)

Calculate repair rate

Parameters:

PGV : pd.Series

Peak ground velocity (m/s)

K : pd.Series

Correction factor

method : int (default = 1)

1 = Linear 2 = Power

Returns:

Repair rate : pd.Series

Number of repairs per m

DTGR(M, M_min, M_max, b)

Returns the the Doubly Truncated Gutenberg Richter cumulative probability for the specified magnitude, magnitude range, and coefficient.

DTGR_inv(P, M_min, M_max, b)

Returns the inverse of the Doubly Truncated Gutenberg Richter distribution for the specified probability, magnitude range, and coefficient.