Damping_Calibration#

class PySeismoSoil.class_damping_calibration.Damping_Calibration(vs_profile: Vs_Profile)[source]#

Bases: object

A class to generate damping curves (and associated soil model parameters) from a given Vs profile.

Methods Summary

`get_H4_x_param`(**kwargs)	Obtain H4_x parameters for each layer (i.e., MKZ model parameters that best fit given damping values, for each layer).
`get_HH_x_param`(**kwargs)	Obtain HH_x parameters for each layer (i.e., HH model parameters that best fit given damping values, for each layer).
`get_damping_curves`([strain_in_pct, ...])	Calculate damping curves using empirical formulas by Darendeli (2001).

Methods Documentation

get_H4_x_param(**kwargs: dict[Any, Any]) → MKZ_Param_Multi_Layer[source]#

Obtain H4_x parameters for each layer (i.e., MKZ model parameters that best fit given damping values, for each layer).

Parameters:

**kwargs (dict[Any, Any]) –

Keyword arguments to be passed to this method:: PySeismoSoil.class_curves.Multiple_Damping_Curves.get_all_H4_x_params().
Check its documentation for details:: https://pyseismosoil.readthedocs.io/en/stable/api_docs/class_curves.html#PySeismoSoil.class_curves.Multiple_Damping_Curves.get_all_H4_x_params

Returns:

H4_x_param – The best parameters for each soil layer found in the optimization.

Return type:

MKZ_Param_Multi_Layer

get_HH_x_param(**kwargs: dict[Any, Any]) → HH_Param_Multi_Layer[source]#

Obtain HH_x parameters for each layer (i.e., HH model parameters that best fit given damping values, for each layer).

Parameters:

**kwargs (dict[Any, Any]) –

Keyword arguments to be passed to this method:: PySeismoSoil.class_curves.Multiple_Damping_Curves.get_all_HH_x_params().
Check its documentation for details:: https://pyseismosoil.readthedocs.io/en/stable/api_docs/class_curves.html#PySeismoSoil.class_curves.Multiple_Damping_Curves.get_all_HH_x_params

Returns:

HH_x_param – The best parameters for each soil layer found in the optimization.

Return type:

HH_Param_Multi_Layer

get_damping_curves(strain_in_pct: ndarray = array([1.00000000e-03, 1.20679264e-03, 1.45634848e-03, 1.75751062e-03, 2.12095089e-03, 2.55954792e-03, 3.08884360e-03, 3.72759372e-03, 4.49843267e-03, 5.42867544e-03, 6.55128557e-03, 7.90604321e-03, 9.54095476e-03, 1.15139540e-02, 1.38949549e-02, 1.67683294e-02, 2.02358965e-02, 2.44205309e-02, 2.94705170e-02, 3.55648031e-02, 4.29193426e-02, 5.17947468e-02, 6.25055193e-02, 7.54312006e-02, 9.10298178e-02, 1.09854114e-01, 1.32571137e-01, 1.59985872e-01, 1.93069773e-01, 2.32995181e-01, 2.81176870e-01, 3.39322177e-01, 4.09491506e-01, 4.94171336e-01, 5.96362332e-01, 7.19685673e-01, 8.68511374e-01, 1.04811313e+00, 1.26485522e+00, 1.52641797e+00, 1.84206997e+00, 2.22299648e+00, 2.68269580e+00, 3.23745754e+00, 3.90693994e+00, 4.71486636e+00, 5.68986603e+00, 6.86648845e+00, 8.28642773e+00, 1.00000000e+01]), use_Darendeli_Dmin: bool = False, show_fig: bool = False) → Multiple_Damping_Curves[source]#

Calculate damping curves using empirical formulas by Darendeli (2001).

Parameters:

strain_in_pct (np.ndarray) – Strain array. Must be a 1D numpy array. Unit: %
use_Darendeli_Dmin (bool) – If True, use the D_min values estimated by the empirical formulas in Darendeli (2001) as the small-strain damping ratios of each soil layer. If False, use the damping ratio provided in vs_profile (or estimated using PySeismoSoil’s built-in Vs-damping correlation).
show_fig (bool) – Whether to show a figure of the damping curves of each layer.

Returns:

mdc – Damping curves for all the soil layers (i.e., not including the rock halfspace at the bottom).

Return type:

Multiple_Damping_Curves