Conditional spectral acceleration under site amplification
site-response.RmdThe site-response model transforms spectral acceleration at a reference condition into spectral acceleration at a target site condition. At oscillator period , denotes the reference spectral acceleration and the site spectral acceleration. The target condition is described by , the travel-time-averaged shear-wave velocity in the uppermost . The random amplification factor relates the accelerations through
Here, is the peak ground acceleration at the reference condition; it conditions the nonlinear part of the factor. The superscript identifies that reference condition. Spectral acceleration and PGA are expressed in , period in , and velocity in . At fixed period, velocities and input PGA, the factor is lognormal, with natural-log mean and natural-log standard deviation . This lognormal distribution is the probabilistic representation that the library applies to the factor. Its natural-log mean combines the adjustment between the and references, a linear term that depends on and a nonlinear term that depends on the input PGA. The library assigns its natural-log variance as a sum of contributions from the linear term, the change of reference and the nonlinear term, without covariances between them; the published model characterizes the uncertainties of its median components as epistemic (Stewart et al. 2020, 1, 6–7, 9). The standard deviation is therefore the dispersion assigned by this formulation and does not by itself represent record-to-record variability.
Fixed reference acceleration and PGA
For fixed values and , multiplication by the factor gives
The notation specifies a normal distribution by its mean and variance (Kroese et al. 2011, sec. 4.2.11, p. 122). The factor parameters are evaluated at the same period, target velocity and conditioning PGA. By the expectation of the lognormal distribution (Kroese et al. 2011, Table 4.18, p. 121), the mean acceleration under this conditional distribution is
Thus the returned mean of the logarithm and the mean acceleration are different quantities. The reference acceleration and PGA in this case are conditioning values; their uncertainty is absent from the conditional distribution.
evaluateSiteFactor() returns
and
as muLnF and sigmaLnF.
evaluateSiteSa() receives aligned Sa and
PGA values and returns muLnSaF and
sigmaLnSaF, the mean and standard deviation of the
logarithm of site acceleration. Both functions receive the period
Tn, target velocity VS30, reference velocity
Vref, and factor identifier model. The
supported identifiers are ST17 and ST20, with
reference velocities of
or
.
These identifiers designate formulations based on the 2017 and 2020
editions of the site amplification model, respectively (Stewart et al. 2017, 13; 2020, 1, 6). When
target and reference velocities coincide, the factor is deterministic
and equal to one, so this conditional acceleration equals
.
Uncertain reference demand within a mixture component
A reference-demand component instead specifies random spectral acceleration and PGA. Their logarithms have means and , standard deviations and , and correlation . For a jointly normal logarithmic pair with positive standard deviations and , the logarithm of reference spectral acceleration conditional on is normal. The model adopts independence between the amplification residual and the reference-acceleration residual once and are fixed. The conditional site acceleration then satisfies
Its conditional logarithmic mean is
Its conditional logarithmic variance is
The factor parameters in these expressions are evaluated at PGA . The variance retains the part of reference-demand variability left after conditioning and adds the factor variance. If , the PGA is constant: the logarithmic mean becomes and the variance becomes , without a division by . At , the reference ordinate is the PGA itself; for positive PGA dispersion, its correlation with itself is one and the conditional reference variance is zero.
integrateSiteMixture() approximates the integration of
these conditional distributions over each component’s PGA distribution
by Gauss-Hermite quadrature when target and reference velocities differ.
Its input contains component labels k, period
Tn, logarithmic parameters muLn and
sigmaLn, and weights w summing to one at each
period. The quadrature requires a matching PGA component at
Tn = 0 for each spectral component. At node
of component
,
with PGA logarithm
,
the site mixture receives a lognormal component when
and a point mass at
when
;
its weight equals the input component weight times the normalized node
weight. When VS30 equals Vref, the function
returns the validated input mixture without quadrature or component
expansion. summarizeMixture() obtains the mean and
requested quantiles from the returned mixture. These are marginal
statistics at each period; they do not specify dependence between
periods or a single realized spectrum. The quantile at probability
is the generalized inverse of the mixture distribution function, the
infimum of the accelerations at which that function reaches
(Kroese et al. 2011, eq. 3.1, p. 45). When
lies within the jump of that function at a point mass, the quantile is
the location of the point mass. The search for the quantile is numerical
and uses a fixed interval of the logarithmic acceleration; that interval
is not guaranteed to bracket the quantile for every probability in
.