reset_timestep command — LIGGGHTS v3.X documentation

# reset_timestep command

## Syntax

    reset_timestep N

- N = timestep number

## Examples

    reset_timestep 0
    reset_timestep 4000000

## Description

Set the timestep counter to the specified value. This command normally comes after the timestep has been set by reading a restart file via the read_restart command, or a previous simulation advanced the timestep.

The read_data and create_box commands set the timestep to 0; the read_restart command sets the timestep to the value it had when the restart file was written.

## Restrictions

This command cannot be used when any fixes are defined that keep track of elapsed time to perform certain kinds of time-dependent operations. All insertion commands are typically using such operations.

Various fixes use the current timestep to calculate related quantities. If the timestep is reset, this may produce unexpected behavior, but LIGGGHTS(R)-PUBLIC allows the fixes to be defined even if the timestep is reset.

Resetting the timestep clears flags for computes that may have calculated some quantity from a previous run. This means these quantity cannot be accessed by a variable in between runs until a new run is performed. See the variable command for more details.

## Related commands

`rerun`

Default: none