Development
The numerical method, runtime controls and available tests provide evidence about a calculation; they do not turn the integration tolerance into a universal trace-error bound.
{{REVISION_NOTICE}}
For each complex frequency and spherical-harmonic degree, YSpec integrates radial systems with source jumps in displacement and traction. A source is rotated to the north pole, where only orders |m| ≤ 2 contribute; the moment tensor and receiver geometry are applied afterward. The radial solution restarts at each model discontinuity and changes form between solid and fluid regions.
The integration uses a Dormand–Prince 5(4) step-controlled method. Each layer uses natural cubic splines through deck knots; gravity is integrated from the density spline. The full derivation and implementation pointers are in the README's How it works section and RadialSolver.
solver.tolerance limits local radial integration error relative to the solution. Tightening it can increase runtime, but a local step criterion is not a guarantee on the end-to-end error of every component, receiver or model. For a calculation that matters, vary the independent controls and compare the outputs of interest:
Frequency-domain damping limits time wraparound for ordinary arrivals. With full gravity, ocean-surface gravity waves can outlast the record and wrap around early at and near the sea surface; a longer record or points below the surface can help. The small fixture on the first-run page is for workflow demonstration, not a converged scientific setup.
The existing CTest suite includes unit tests, comparisons to the original Fortran solver for selected cases, normal-mode and homogeneous-sphere checks, direct shooting, ocean/core responses, snapshot–seismogram agreement, strain reciprocity and finite-difference comparisons for radial kernels. Four end-to-end cases compare saved traces with Fortran references. Those tests describe checked cases; they do not establish accuracy for arbitrary inputs.
Use the project's standard routes: ctest --test-dir build --output-on-failure for the configured build and cmake --preset serial, cmake --build --preset serial, ctest --preset serial for the existing serial route. The current inventory is summarized in coverage and maintenance. Reference data regeneration scripts are in tests/fortran; regeneration requires a separate Fortran YSpec checkout and is not part of docs CI.