Shared top-level members

MemberRequired value and unitsDefault or constraints
modelMinos deck path, relative to the JSON fileRequired; 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_serieslength_min and optional time_step_sLength and step must be positive; absent step is 0.25 / maximum frequency in Hz
sourcesNon-empty array of sourcesEach source requires depth (km), latitude (−90..90°), longitude (°), and a moment tensor, force, or both
attenuationBoolean; include attenuation when trueDefaults to true
gravityOne of "none", "cowling", "full"Defaults to "full"
filter_mHzOptional four-number arrayRising corner pair then pass band then falling pair: 0 ≤ f1 ≤ f2 < f3 ≤ f4
solverOptional tolerance, start_decayDefaults 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 receivers

output 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 grid

The 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.

Parser-backed source

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.