run_time command

Purpose

Command for defining the total runtime of the simulation.

Syntax

run_time T keyword
  • T = time of simulation

  • zero or more keyword/value pairs may be appended

  • keyword = upto upto value = none

Examples

run_time 1.0
run_time 2.0 upto

Description

Run or continue dynamics for a specified time (“run_time”).

A value of T = 0 is acceptable; only the thermodynamics of the system are computed and printed without performing a timestep.

The upto keyword means to perform a run starting at the current time up to the specified time. E.g. if the current run time is 1 s and “run_time 10. upto” is used, then an additional 9 seconds will be run. This can be useful for very long runs on a machine that allocates chunks of time and terminate your job when time is exceeded. If you need to restart your script multiple times (reading in the last restart file), you can keep restarting your script with the same run command until the simulation finally completes.

Warning

This command is deprecated. You should use the simulate command instead.

Restrictions

The specified time is restricted in such a way that the resulting number of time steps fits in a signed 32-bit integer, so you are limited to slightly more than 2 billion steps (2^31) in a single run. However, you can perform successive runs to run a simulation for any number of steps (ok, up to 2^63 steps).