Model decks

model names a Minos/MINEOS deck in SI units. The parser accepts the six-column isotropic form (radius, density, P and S wave speeds, bulk and shear quality factors) and the nine-column transversely isotropic form (radius, density, Vpv, Vsv, Qκ, Qμ, Vph, Vsh, η). The bundled PREM deck is a nine-column example. Header metadata and repeated radii describe the layer boundaries; preserve deck ordering and discontinuities when preparing a model.

Each layer's properties are represented by natural cubic splines through its knots. Consecutive layers of the same phase form a region. Gravity follows from the density profile. The solver and Model use nondimensional quantities internally; the public model API exposes scales for conversion to and from SI.

Discontinuities and sides

Layer boundaries are retained, including repeated-radius one-sided values. The C++ model lookup API accepts YSpec::Side::Below or YSpec::Side::Above; its default is Below. A source or receiver exactly on a solid–fluid boundary is interpreted on the solid side by the radial solver. Every source in one calculation must be in the same solid region. Receivers and snapshot points may be in a fluid or core but cannot be at the centre. See RadialSolver's boundary contract and Model::LayerIndex.

Seismogram files

For one source, outputs are <prefix>.1, <prefix>.2, and so on in receiver order. For multiple sources with names, outputs are <prefix>.<name>.1 and so on; unnamed sources use their sequence numbers. Each row has four whitespace-separated columns: time after origin (s), vertical up, north and east. Without an instrument, components use the selected displacement (m), velocity (m/s) or acceleration (m/s²) quantity. With a SAC pole-zero instrument, values are in the instrument output units.

Receiver ordering is group by group; within each group, depths are traversed in order, and every location is emitted at each depth. Geographic locations are [latitude, longitude] in degrees. Snapshot components instead follow up, away along the source great circle, and transverse (90° anticlockwise from away viewed from above).

Snapshot files

One file is written per source and requested time, numbered in time order; named sources appear in the filename only when there are several sources. Two comment lines precede the data. Each row contains depth (km), distance and azimuth from source (degrees), latitude, longitude, then up, away and transverse values. Grid iteration order is depth, azimuth, distance. The grid is shared in each source's local frame. The three components use the selected output quantity: displacement (m), velocity (m/s) or acceleration (m/s²), matching the seismogram quantity selection.

See WriteSnapshots for the public writer contract and a small checked snapshot command.