Troubleshooting

Symptom	Check or action
INI section/key error	Use a complete template; all general sections are parsed even for static work
Input file not found	Resolve paths against the process directory; use absolute paths without surrounding quotes
Missing solver executable	Check the active environment and the matching pygrnwang installation
Numerical DLL error on Windows	Activate Conda or use conda run -n ...; do not call an inactive interpreter directly
Multiprocessing bootstrap RuntimeError	Add a main guard and run from a script
Fixed-depth CLI does no work	The configured depth must be greater than zero
Missing static tensor during dynamics	Compute matching static results first when correct_zero_freq=True
Correction enabled but not applied	Set a justified finite max_slowness and a sufficient correction window
Full-tensor stress appears scaled by a million	INI uses MPa; direct Python APIs use Pa
Static and dynamic amplitudes disagree	Compare local rigidity × area × slip against supplied moment, then examine STF and baseline settings
Unexpectedly missing source patches	Check CSV missing values, slip threshold and STF cutoff
Source concatenation or grid reshape failure	Check equal STF lengths, row counts and [n_strike,n_dip] shapes
Wrong or repeated dynamic receiver output	Check collisions in four-decimal per-point names and concurrent writes
Reused results after changing the model	Use a fresh library/output directory; cache signatures do not hash all native files
Excess memory use	Reduce source–receiver pairs, grid points, time samples or workers; final arrays remain fully assembled
Optimized CFS not found by a plotter	Load its _os or _oop filename explicitly and use an array-based plot
GIF import failure	Install the optional imageio package
Small tutorial refuses to run again	Select a new or empty --output-dir

Useful evidence for a bug report

Record the source revision, versions, platform, exact command, full error trace, INI and a small input subset. Preserve native solver logs and green_lib_info.json. Reproduce with one receiver or a small grid when possible.

Documentation checks establish that the pages build and reference real signatures. They do not establish numerical convergence or validate all backend/receiver combinations.