Calculate Displacement Products from Explicit Demand Tables

Performs the site-response, sampling and ensemble chain for one site. The caller supplies the rock spectra, MCE, geotechnical table and all scientific settings. No project directories, files or environment variables are read.

Usage

fitDnProducts(
  rock,
  mce,
  shear,
  modelID,
  siteID,
  family,
  vref,
  mw,
  ns,
  weights,
  zTrunc,
  seeds,
  useParallel = FALSE,
  workers = 1L
)

Arguments

rock

Period-wise rock lognormal table with the UHSRock schema.

mce

MCE quantiles with Tn, p, Sa, Vs30, Vref, ID and siteID; no TR.

shear

Geotechnical table from getTs(); its mean rows are used.

modelID

Identifier of the probabilistic demand model.

siteID

Site identifier present in the demand tables.

family

Positive return periods, in years.

vref

Reference rock velocity in m/s (760 for this product contract).

mw

Earthquake magnitude.

ns

Number of simulations per geometry and material.

weights

Named positive model weights, after regime selection with getDnWeights() when using the project on/off convention.

zTrunc

Positive truncation level of the probabilistic rock demand.

seeds

Explicit integer seeds in sorted return-period order followed by MCE, or NULL to consume the caller's current random stream. Seeds are applied after deterministic site preparation, before each demand's draws.

useParallel, workers

Controls passed to fitDnScenarios().

Value

A list with curve, draws and pga data.tables. Displacements are cm; PGA and ky are g. MCE rows retain TR = NA. Inputs are unchanged.