status command

Warning

GPU support for this command has not been tested and may not work as expected.

Syntax

status N
  • N = output status every N timesteps

  • N can be a variable (see below)

Examples

status 100

Description

Compute and print status info (e.g. kinetic energy, number of atoms, time, pressure) on timesteps that are a multiple of N and at the beginning and end of a simulation. A value of 0 will only print status information at the beginning and end.

The content and format of what is printed is controlled by the status_style and status_modify commands.

Instead of a numeric value, N can be specified as an equal-style variable, which should be specified as v_name, where name is the variable name. In this case, the variable is evaluated at the beginning of a run to determine the next timestep at which status info will be written out. On that timestep, the variable will be evaluated again to determine the next timestep, etc. Thus the variable should return timestep values. See the stagger() and logfreq() and stride() math functions for equal-style variables, as examples of useful functions to use in this context. Other similar math functions could easily be added as options for equal-style variables.

For example, the following commands will output status info at timesteps 0,10,20,30,100,200,300,1000,2000,etc:

variable    s equal logfreq(10,3,10)
status      v_s

Restrictions

none

Default

status 0