Restarting a simulation

Note

This page is a stub. The parameter names below are taken from the GLM 4 source, but the worked example and guidance still need to be written.

GLM 4 can save the model state during a run and resume from it later. In the GLM 3.x line this was available only as an optional source patch; in 4.x it is built into the model.

Writing restart files

The following parameters control restart output:

Parameter	Purpose
restart_fname	Name of the restart file to write
restart_nsave	How often the restart state is written
restart_swold	Retain/overwrite behaviour for previous restart files

Resuming from a restart file

Restart input is configured in the &init_profiles block:

Parameter	Purpose
init_restart_from_file	Set non-zero to initialise from a restart file rather than from the specified profiles
init_restart_fname	Name of the restart file to read

If init_restart_from_file is set but the named file cannot be read, GLM issues a warning and falls back to initialising from the profiles in &init_profiles — so check the run log to confirm the restart was actually loaded. On success the model reports:

Restart state loaded from <filename>

Still to document

• A complete worked example, with the relevant .nml excerpts.
• Whether restart files are portable between model versions and platforms.
• Interaction with water quality state when AED is enabled.