To maintain compatibility with current workflows while adding additional functionality to the workflow, we intend to change the way perturbed source parameters are passed to the components of the slurm ground motion workflow.
Changes to implement
To present the parameters to slurm workflow in a way that they can be used by the appropriate part of the workflow, we have decided that changes should be made to Pre Processing such that the user must specify which part of the workflow each parameter belongs to during srf creation.
These changes will then flow on to simulation installation and subsequently submission to the workflow.
User input
Currently any parameters that are to be included in the realisation (perturbed or not) are included in the additional options yaml file, while the perturbation values are given in the source uncertanities yaml file.
We intend to merge these files.
The nominal values and perturbation settings for each of these parameters will have to be given in the source uncertainties yaml (as passed to gcmt2srf).
Each parameter that is given in the CMT solutions csv file will be at the top level, while each additional parameter will be nested inside the relevant process.
Each parameter will have at least two associated pieces of information, being the nominal value (mean) of the parameter, and the distribution. If the distribution requires any random variables, these must also be given.
An example is available below:
mw: distribution: uniform halfrange: 0.05 hf: sdrop: mean: 50 halfrange: 5 distribution: uniform rvfac: mean: 0.8 std_dev: 0.01 distribution: normal rvfac_shallow: mean: 0.7 distribution: none bb: fmin: mean: 0.2 distribution: uniform_relative scalefactor: 0.05
Internal changes
In order to simplify the implementation of this, we have chosen to have every parameter added to the slurm script and passed as an argument to the simulation script, which will then discard any parameters it does not recognize.
Parameters for each component
The parameters for each component are as follows:
hf | bb | |
---|---|---|
flo | ✓ | |
fmin | ✓ | |
fmidbot | ✓ | |
lfvsref | ✓ | |
sim_bin | ✓ | |
t-sec | ✓ | |
sdrop | ✓ | |
rayset | ✓ | |
seed | ✓ | |
duration | ✓ | |
dt | ✓ | |
fmax | ✓ | |
kappa | ✓ | |
qfexp | ✓ | |
rvfac | ✓ | |
rvfac_shallow | ✓ | |
rvfac_deep | ✓ | |
czero | ✓ | |
calpha | ✓ | |
mom | ✓ | |
rupv | ✓ | |
velocity-model | ✓ | |
site-vm-dir | ✓ | |
vs-moho | ✓ | |
fa_sig1 | ✓ | |
fa_sig2 | ✓ | |
rv_sig1 | ✓ | |
hf_path_dur | ✓ |