Site design spectra

subsurfaceio.functions.site_design_spectra

Site design spectra functions.

Functions:

Name	Description
`get_factors__carlton2018simplified`	Calculation function.
`get_pseudo_spectral_acceleration__carlton2018simplified`	Calculation function.

get_factors__carlton2018simplified

get_factors__carlton2018simplified(
    period,
    special_layers_thickness,
    special_shear_velocity_mean,
    special_shear_strain_mean,
    special_cyclic_resistance_ratio_min,
)

Calculation function.

\[ \begin{array}{l} \mathbf{function} \ \mathrm{get\_factors\_\_carlton2018simplified}(T, H, V_{s\ mean}, γ_{0.5\ mean}, CRR_{min}) \\ \hspace{1em} \mathrm{ref} \gets \mathrm{ReferenceDataSets}.\mathrm{Carlton2018Table6} \\ \hspace{1em} \mathopen{}\left( \mathrm{c\_1}, \mathrm{c\_2}, \mathrm{c\_3}, \mathrm{c\_4}, \mathrm{c\_5}, \mathrm{c\_6} \mathclose{}\right) \gets \mathrm{ref}.\mathrm{grid\_interpolation} \mathopen{}\left( T, \mathopen{}\left[ \mathopen{}\left[ 1 \mathclose{}\right], \mathopen{}\left[ 2 \mathclose{}\right], \mathopen{}\left[ 3 \mathclose{}\right], \mathopen{}\left[ 4 \mathclose{}\right], \mathopen{}\left[ 5 \mathclose{}\right], \mathopen{}\left[ 6 \mathclose{}\right] \mathclose{}\right], \textrm{"period"} \mathclose{}\right) \\ \hspace{1em} \mathrm{f1} \gets \mathrm{c\_1} + \mathrm{c\_2} \cdot \log H + \mathrm{c\_3} \cdot \log V_{s\ mean} + \mathrm{c\_4} \cdot \log γ_{0.5\ mean} \\ \hspace{1em} \mathrm{f2} \gets \mathrm{c\_5} + \mathrm{c\_6} \cdot \log CRR_{min} \\ \hspace{1em} \mathbf{return} \ \mathopen{}\left( \mathrm{f1}, \mathrm{f2} \mathclose{}\right) \\ \mathbf{end \ function} \end{array} \]

Parameters:

Name	Type	Description	Default
`period`	`float`	Vibration period of structure or soil	required
`special_layers_thickness`	`float`	Thickness of special soil layers (NEHRP F site classification)	required
`special_shear_velocity_mean`	`float`	Mean shear wave velocity of special soil layers	required
`special_shear_strain_mean`	`float`	Mean shear strain at G/G_max=0.5 for special soil layers	required
`special_cyclic_resistance_ratio_min`	`float`	Minimum cyclic resistance ratio for special soil layers	required

Returns:

Name	Type	Description
`f1`	`Any`	f1
`f2`	`Any`	f2

get_pseudo_spectral_acceleration__carlton2018simplified

get_pseudo_spectral_acceleration__carlton2018simplified(
    period,
    pseudo_spectral_acceleration,
    special_layers_thickness,
    special_shear_velocity_mean,
    special_shear_strain_mean,
    special_cyclic_resistance_ratio_min,
    period_new=None,
    number_of_standard_deviations=0,
)

Calculation function.

\[ \begin{array}{l} \mathbf{function} \ \mathrm{get\_pseudo\_spectral\_acceleration\_\_carlton2018simplified}(T, PSa, H, V_{s\ mean}, γ_{0.5\ mean}, CRR_{min}, \mathrm{period\_new}, \mathrm{number\_of\_standard\_deviations}) \\ \hspace{1em} \mathbf{if} \ \mathrm{period\_new} \not\equiv \mathrm{None} \\ \hspace{2em} PSa \gets \mathrm{np}.\mathrm{interp} \mathopen{}\left( \mathrm{period\_new}, T, PSa \mathclose{}\right) \\ \hspace{2em} T \gets \mathrm{period\_new} \\ \hspace{1em} \mathbf{end \ if} \\ \hspace{1em} \mathopen{}\left( \mathrm{f1}, \mathrm{f2} \mathclose{}\right) \gets \mathrm{get\_factors\_\_carlton2018simplified} \mathopen{}\left( T, H, V_{s\ mean}, γ_{0.5\ mean}, CRR_{min} \mathclose{}\right) \\ \hspace{1em} \mathbf{if} \ \mathrm{number\_of\_standard\_deviations} > 0 \\ \hspace{2em} \mathrm{table7} \gets \mathrm{ReferenceDataSets}.\mathrm{Carlton2018Table7} \\ \hspace{2em} \mathrm{std} \gets \mathrm{number\_of\_standard\_deviations} \cdot \mathrm{np}.\mathrm{interp} \mathopen{}\left( T, \mathopen{}\left[ x_{\textrm{"period"}} \mid x \in \mathrm{table7} \mathclose{}\right], \mathopen{}\left[ x_{\textrm{"σtotal"}} \mid x \in \mathrm{table7} \mathclose{}\right] \mathclose{}\right) \\ \hspace{1em} \mathbf{else} \\ \hspace{2em} \mathrm{std} \gets 0 \\ \hspace{1em} \mathbf{end \ if} \\ \hspace{1em} \mathrm{amp} \gets \exp \mathopen{}\left( \mathrm{f1} + \mathrm{f2} \cdot \log \mathopen{}\left( \frac{PSa + 0.1}{0.1} \mathclose{}\right) + \mathrm{std} \mathclose{}\right) \\ \hspace{1em} PSa \gets PSa \cdot \mathrm{amp} \\ \hspace{1em} \mathbf{return} \ PSa \\ \mathbf{end \ function} \end{array} \]

Parameters:

Name	Type	Description	Default
`period`	`float`	Vibration period of structure or soil	required
`pseudo_spectral_acceleration`	`float`	Pseudo-spectral acceleration for seismic analysis	required
`special_layers_thickness`	`float`	Thickness of special soil layers (NEHRP F site classification)	required
`special_shear_velocity_mean`	`float`	Mean shear wave velocity of special soil layers	required
`special_shear_strain_mean`	`float`	Mean shear strain at G/G_max=0.5 for special soil layers	required
`special_cyclic_resistance_ratio_min`	`float`	Minimum cyclic resistance ratio for special soil layers	required
`period_new`	`Any`	period_new	`None`
`number_of_standard_deviations`	`float`	Number of standard deviations for statistical analysis	`0`

Returns:

Name	Type	Description
`pseudo_spectral_acceleration`	`float`	Pseudo-spectral acceleration for seismic analysis