Prepare the input

Build yspec as described in the installation guide. From the repository root, make a fresh run directory and copy the checked tutorial input and model into it. Inputs and outputs resolve relative to the JSON file, so the calculation writes only inside this directory.

mkdir -p build/first-seismogram
cp docs/site/examples/first-seismogram.json build/first-seismogram/input.json
cp examples/prem.200 build/first-seismogram/prem.200

Run the calculation

Use a deliberate thread limit. The small band, degree range and single receiver make this a first run, not a precision benchmark.

cd build/first-seismogram
OMP_NUM_THREADS=2 ../guide/bin/yspec input.json
ls first-seismogram.out.*

The program reports the model, degree/frequency ranges, sources, receivers and thread count on standard error, then writes the trace first-seismogram.out.1 and first-seismogram.out.receivers, a table giving, for each trace file, its source, the receiver's latitude, longitude and depth, and the epicentral distance, azimuth and back-azimuth.

Read the output

Each row contains four whitespace-separated values: time after the origin in seconds, then vertical (up), north and east displacement in metres. This file has 91 samples from 0 to 1800 seconds at 20-second intervals. A nonzero vertical trace follows from the radial moment tensor and the receiver's 30-degree epicentral distance.

Download the exact input fixture and the illustrative SVG plot, and read the plot provenance record. The illustration was generated from this fixture run. To reproduce it from the repository root after the calculation, run:

python3 docs/site/examples/plot_first_seismogram.py \
  build/first-seismogram/first-seismogram.out.1 \
  build/first-seismogram/first-seismogram.svg
Vertical displacement trace from zero to 1800 seconds
Vertical displacement at 30° epicentral distance; the displayed scale is in metres.

To check a scientific result, vary the maximum degree, upper frequency, record length and integration tolerance separately. The solver tolerance is local to each integration step and does not directly bound the final trace error.