/STOP

Engine Keyword The Engine is stopped, due to reached energy error ratio criteria, total mass ratio criteria or nodal mass ratio criteria.

Format

/STOP

`E`_max	$Δ M_{\max}$	$Δ N_{\max}$	`N`_TH	`N`_ANIM	`N`_{ERR_POSIT}

Field	Contents	SI Unit Example
`E`_max	Energy error ratio. Defined as the ratio of the current simulation energy to the initial energy plus the work added in the system. Unlike the energy error listed in the Engine output file, this value can be greater than 0.999 (99.9%). By default, the run is stopped, if the absolute value of the energy error is exceeded. To only stop for positive energy error, use `N`_{ERR_POSIT} =1. Default = 10³⁰
$Δ M_{\max}$	Total mass added ratio criteria is defined as the ratio of total added mass of the model at a given time divided by the initial total mass. Default = 10³⁰
$Δ N_{\max}$	Nodal mass ratio criteria. Defined for each node as the ratio of its mass divided by its initial mass. The computation is stopped; if, at least, one node meets the criteria. Default = 10³⁰
`N`_TH	= 0 (Default) The Engine is stopped without Time History file. = 1 A Time History file is written if the Engine is stopped, due to energy error ratio criteria.
`N`_ANIM	= 0 (Default) The Engine is stopped without animation file. = 1 An animation file is written if the Engine is stopped, due to energy error ratio criteria.
`N`_{ERR_POSIT}	= 0 (Default) The Engine is stopped when the absolute value of the energy error is more than `E`_max = 1 Only positive energy error is checked for stopping the Engine. Engine is stopped when the energy error is more than `E`_max.

Energy error ratio:(1)
$\frac{E_{k} + E_{k}^{r} + E_{i}}{E_{k, 1} + E_{_{k, 1}}^{r} + E_{i, 1} + E_{w k} - E_{w k, 1}} - 1$

Where,

$E_{k}$

Translational kinetic energy at current time.

$E_{k}^{r}$

Rotational kinetic energy at current time.

$E_{i}$

Internal energy.

$E_{w k}$

Work of external forces (energy brought to the system).

$E_{, 1}$

Energy at beginning of the RUN (not at time t=0).
To find the divergence of the Engine run, it is better to only check for the positive energy error and not the negative energy error. To find early divergence, it is recommended to use N_{ERR_POSIT}= 1, N_TH = 1, N_ANIM = 1, and a relatively low value for E_max.
The total mass criteria is defined as the ratio of total added mass at a given time divided by the initial total mass.
The nodal mass ratio criteria is defined for each node as the ratio of its mass divided by its initial mass. The computation is stopped, if at least one node meets the criteria.
A restart file is written, if the Engine is stopped, due to one of these events.