Reference
Both programs read strict JSON. The input names units where they differ from the high-level SI C++ interface; unknown or misspelled members are errors.
{{REVISION_NOTICE}}
| Member | Required value and units | Default or constraints |
|---|---|---|
model | Minos deck path, relative to the JSON file | Required; six-column isotropic or nine-column transversely isotropic deck |
degrees | {"max": integer, "min": integer} | min defaults to 0; require 0 ≤ min ≤ max |
frequencies_mHz | {"min": positive, "max": greater} | Required; values are converted from mHz to Hz |
time_series | length_min and optional time_step_s | Length and step must be positive; absent step is 0.25 / maximum frequency in Hz |
sources | Non-empty array of sources | Each source requires depth (km), latitude (−90..90°), longitude (°), and a moment tensor, force, or both |
attenuation | Boolean; include attenuation when true | Defaults to true |
gravity | One of "none", "cowling", "full" | Defaults to "full" |
filter_mHz | Optional four-number array | Rising corner pair then pass band then falling pair: 0 ≤ f1 ≤ f2 < f3 ≤ f4 |
solver | Optional tolerance, start_decay | Defaults 1e−5 and 11; tolerance must be between 0 and 1, decay positive |
JSON lengths are minutes and sample steps seconds. Depths use kilometres. Source and receiver positions are geographic degrees. Moment-tensor components are N m and force components N in local spherical coordinates (r up, θ south, φ east). All six moment-tensor members are required when the tensor is supplied; force components default to zero.
yspec: seismogram outputs and receiversoutput is required and accepts prefix, optional quantity (displacement, velocity, acceleration; defaults to displacement) and optional potential_and_tilt_corrections (false by default). Corrections apply to acceleration. receivers is one receiver group or a non-empty array of groups; each has one or more depth_km values and exactly one of locations or profile. A location is [latitude, longitude]. Profiles use either from + to, or from + azimuth_deg + a two-value distances_deg; both forms require a positive count. A group may name one SAC pole-zero instrument file.
Model, instrument and output-prefix paths resolve relative to the JSON file. Output directories are not created automatically: use a fresh existing run directory. Receiver order is group order, then each group's depth order, with all locations at each depth.
yspec-snapshot: snapshot gridThe snapshot form replaces receivers with snapshots. Its output accepts only prefix and optional quantity (displacement, velocity or acceleration; defaults to displacement). Snapshot members are times_s, depths_km, distances_deg and azimuths_deg. Each accepts a number, a non-empty array, or an inclusive {"min": ..., "max": ..., "count": ...} range. Times must be within the record, depths non-negative, and distances 0..180°.
The downloadable small snapshot fixture exercises that schema with one source, one time, one depth, two distances and two azimuths.
This summary follows ReadSeismogramInput, ReadSacPoleZero and the parser implementation. The maintained parser tests are tests/TestInput.cpp; they cover defaults, names, profiles, instruments, forces and rejected input. For complete member-level details, follow the linked API docs and tests.