Site Scaling
Site response is defined in terms of site amplification, or impedance effects, as well as damping – via a kappa filter.
The overall site model is therefore written as: $S(f; \bm{\theta}_S) = S_I(f) \times S_K(f)$ with $S_I(f)$ representing the impedance effects, and $S_K(f)$ being the kappa filter.
Impedance functions
Impedance effects are represented using custom types that define an amplification
function. These functions take a frequency as an argument and return the corresponding amplification level. Each of these custom types is a subtype of the abstract type SiteAmplification
Currently, the following impedance functions (custom types) are implemented:
SiteAmpBoore2016_760
: is the Boore (2016) impedance function for a Western US generic rock profile with $V_{S,30}=760$ m/sSiteAmpAlAtikAbrahamson2021_ask14_620
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Abrahamson et al. (2014) GMM. The reference profile has a $V_{S,30}=620$ m/sSiteAmpAlAtikAbrahamson2021_ask14_760
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Abrahamson et al. (2014) GMM. The reference profile has a $V_{S,30}=760$ m/sSiteAmpAlAtikAbrahamson2021_ask14_1100
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Abrahamson et al. (2014) GMM. The reference profile has a $V_{S,30}=1100$ m/sSiteAmpAlAtikAbrahamson2021_bssa14_620
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Boore et al. (2014) GMM. The reference profile has a $V_{S,30}=620$ m/sSiteAmpAlAtikAbrahamson2021_bssa14_760
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Boore et al. (2014) GMM. The reference profile has a $V_{S,30}=760$ m/sSiteAmpAlAtikAbrahamson2021_bssa14_1100
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Boore et al. (2014) GMM. The reference profile has a $V_{S,30}=1100$ m/sSiteAmpAlAtikAbrahamson2021_cb14_620
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Campbell & Bozorgnia (2014) GMM. The reference profile has a $V_{S,30}=620$ m/sSiteAmpAlAtikAbrahamson2021_cb14_760
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Campbell & Bozorgnia (2014) GMM. The reference profile has a $V_{S,30}=760$ m/sSiteAmpAlAtikAbrahamson2021_cb14_1100
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Campbell & Bozorgnia (2014) GMM. The reference profile has a $V_{S,30}=1100$ m/sSiteAmpAlAtikAbrahamson2021_cy14_620
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Chiou & Youngs (2014) GMM. The reference profile has a $V_{S,30}=620$ m/sSiteAmpAlAtikAbrahamson2021_cy14_760
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Chiou & Youngs (2014) GMM. The reference profile has a $V_{S,30}=760$ m/sSiteAmpAlAtikAbrahamson2021_cy14_1100
: is the Al Atik & Abrahamson (2021) impedance function obtained by inverting the Chiou & Youngs (2014) GMM. The reference profile has a $V_{S,30}=1100$ m/sSiteAmpUnit
: simply provides a unit impedance for all frequencies, i.e., $S_I(f)=1.0$SiteAmpConstant
: provides a constant,c
, impedance for all frequencies, i.e., $S_I(f)=c$
StochasticGroundMotionSimulation.site_amplification
— Functionsite_amplification(f::T, amp_model::S; fmin=1e-3, fmax=999.99) where {T<:Real,S<:SiteAmplification}
Computes the site amplification (impedance) for a given frequency f
. The argument amp_model
is a subtype of the abstract type SiteAmplification
.
# Examples
f = 5.0
# returns the amplification from AlAtik (2021) in both cases
Af = site_amplification(f)
Af = site_amplification(f, SiteAmpAlAtikAbrahamson2021_cy14_760())
# returns the Boore (2016) amplification
Af = site_amplification(f, SiteAmpBoore2016_760())
# returns 1.0
Af = site_amplification(f, SiteAmpUnit())
site_amplification(f::Vector{T}, amp_model::S; fmin=1e-3, fmax=999.99) where {T<:Real,S<:SiteAmplification}
Computes the site amplification (impedance) for a given frequency f
. The argument amp_model
is a subtype of the abstract type SiteAmplification
.
# Examples
f = 5.0
# returns the amplification from AlAtik (2021) in both cases
Af = site_amplification(f)
Af = site_amplification(f, SiteAmpAlAtikAbrahamson2021_cy14_760())
# returns the Boore (2016) amplification
Af = site_amplification(f, SiteAmpBoore2016_760())
# returns 1.0
Af = site_amplification(f, SiteAmpUnit())
site_amplification(f, site::SiteParameters)
Computes the site amplification (impedance) for a given frequency f
.
site_amplification(f, fas::FourierParameters)
Computes the site amplification (impedance) for a given frequency f
.
StochasticGroundMotionSimulation.SiteAmpUnit
— Typestruct SiteAmpUnit <: SiteAmplification
Unit amplification function.
StochasticGroundMotionSimulation.SiteAmpConstant
— Typestruct SiteAmpConstant <: SiteAmplification
Constant amplification function
StochasticGroundMotionSimulation.SiteAmpBoore2016_760
— Typestruct SiteAmpBoore2016_760 <: SiteAmplification
Implementation of the Boore (2016) amplification function for Vs30 = 760 m/s
Examples
f = 5.0
sa = SiteAmpBoore2016_760()
Af = sa.amplification(f)
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_ask14_620
— Typestruct SiteAmpAlAtikAbrahamson2021_ask14_620 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Abrahamson et al. (2014) GMM, for Vs30 = 620 m/s
Examples
f = 5.0
sa = SiteAmpAlAtikAbrahamson2021_ask14_620()
Af = sa.amplification(f)
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_ask14_760
— Typestruct SiteAmpAlAtikAbrahamson2021_ask14_760 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Abrahamson et al. (2014) GMM, for Vs30 = 760 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_ask14_1100
— Typestruct SiteAmpAlAtikAbrahamson2021_ask14_1100 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Abrahamson et al. (2014) GMM, for Vs30 = 1100 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_bssa14_620
— Typestruct SiteAmpAlAtikAbrahamson2021_bssa14_620 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Boore et al. (2014) GMM, for Vs30 = 620 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_bssa14_760
— Typestruct SiteAmpAlAtikAbrahamson2021_bssa14_760 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Boore et al. (2014) GMM, for Vs30 = 760 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_bssa14_1100
— Typestruct SiteAmpAlAtikAbrahamson2021_bssa14_1100 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Boore et al. (2014) GMM, for Vs30 = 1100 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cb14_620
— Typestruct SiteAmpAlAtikAbrahamson2021_cb14_620 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Campbell & Bozorgnia (2014) GMM, for Vs30 = 620 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cb14_760
— Typestruct SiteAmpAlAtikAbrahamson2021_cb14_760 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Campbell & Bozorgnia (2014) GMM, for Vs30 = 760 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cb14_1100
— Typestruct SiteAmpAlAtikAbrahamson2021_cb14_1100 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Campbell & Bozorgnia (2014) GMM, for Vs30 = 1100 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cy14_620
— Typestruct SiteAmpAlAtikAbrahamson2021_cy14_620 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Chiou & Youngs (2014) GMM, for Vs30 = 620 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cy14_760
— Typestruct SiteAmpAlAtikAbrahamson2021_cy14_760 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Chiou & Youngs (2014) GMM, for Vs30 = 760 m/s
StochasticGroundMotionSimulation.SiteAmpAlAtikAbrahamson2021_cy14_1100
— Typestruct SiteAmpAlAtikAbrahamson2021_cy14_1100 <: SiteAmplification
Implementation of the Al Atik & Abrahamson (2021) amplification function for the Chiou & Youngs (2014) GMM, for Vs30 = 1100 m/s
Kappa filter
In addition to the impedance effects, the near surface damping is represented by a generic kappa filter:
\[S_K(f) = \exp\left( -\pi \kappa_0 f \right)\]
StochasticGroundMotionSimulation.kappa_filter
— Functionkappa_filter(f, site::SiteParameters)
Kappa filter for a given frequency f
kappa_filter(f::Vector{T}, site::SiteParameters) where {T<:Real}
Kappa filter for a given frequency vector f