newmark answers one question: given a site-specific
seismic hazard and a slope with known dynamic properties, what
horizontal seismic coefficient k_max is required to limit
permanent co-seismic displacement to a specified target d*?
The performance-based design problem is formulated as: for a given target tolerable displacement d* > 0, target return period T_R, and target exceedance probability p ∈ (0, 1), choose the smallest yield coefficient k_y such that the displacement induced at T_R remains below d* with probability at least 1 − p:
\[ k_\text{max}(p \mid d^*, T_R) \;=\; \inf\!\Bigl\{\,k_y \,:\, P\!\bigl[\,D_N(k_y; T_R) > d^*\,\bigr] \,\leq\, p\,\Bigr\}. \]
The right-hand side has no closed form — neither the joint distribution of intensity measures nor the convolution with the empirical regression residual admits one. The framework evaluates the inverse mapping numerically via Monte Carlo, propagating two sources of uncertainty:
For the full mathematical derivation and calibration discussion, see:
Verri Kozlowski, A. (2026). Probabilistic estimation of Newmark displacements and seismic coefficients under hazard uncertainty. Working paper.
fitSaF)Rock-level spectral ordinates are amplified to the target site Vs30 using the Seyhan & Stewart (2014) nonlinear site-factor model (ST17).
See ?fitSaF for the function-level interface.
fitDnCurve)For each Monte Carlo realisation, one ground-motion scenario is drawn (a consistent tuple of PGA, Sa(1.3Ts), Sa(1.5Ts)) and passed through all active displacement models simultaneously using a shared aleatory residual. The result is a family of coherent displacement curves D_N(k_y).
invertDnDraws)Each curve is projected monotone and inverted in log-log space to find the yield acceleration k_max such that D_N(k_max) = d*. Mean and quantiles of k_max over all realisations constitute the output.
| ID | Authors | Type | Spectral reference |
|---|---|---|---|
| AM88 | Ambraseys & Menu (1988) | rigid block | PGA |
| JB07 | Jibson (2007) | rigid block | PGA, Arias intensity |
| SR08 | Saygili & Rathje (2008) | rigid block | PGA, Arias intensity |
| BT07 | Bray & Travasarou (2007) | flexible block | Sa(1.5 Ts) |
| BM17 | Bray, Macedo & Travasarou (2018) | flexible block, subduction | Sa(1.5 Ts) |
| BM19 | Bray & Macedo (2019, corr. 2023) | flexible block, crustal | Sa(1.3 Ts) |
Activate/deactivate models via the weights argument (0 =
inactive).
For BM19, near-fault pulse motions are flagged when PGV > 115 cm
s⁻¹ and the equation switches to the Bray-Macedo (2023) D100 / D50 form
controlled by the NFC argument ("D100" is the
maximum-component default, conservative for slopes within ±45° of
fault-normal; "D50" is the median-component case for other
orientations). A sub-regime split at PGV = 150 cm s⁻¹ inside the pulse
equation captures the saturation of seismic displacement at very high
PGV.
getKyLimits()) are reported as a
diagnostic but not enforced as a clamp inside
invertDnDraws().getDnKy()).p argument to
invertDnDraws().