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 <: SiteAmplificationUnit amplification function.
StochasticGroundMotionSimulation.SiteAmpConstant — Typestruct SiteAmpConstant <: SiteAmplificationConstant amplification function
StochasticGroundMotionSimulation.SiteAmpBoore2016_760 — Typestruct SiteAmpBoore2016_760 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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 <: SiteAmplificationImplementation 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