/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	Content	SI Unit Example
`E`_max	Energy error ratio. Defined as the ratio of the current simulation energy to the total energy in the system. Unlike the energy error listed in the engine output file, this value can be greater than 0.999 (99.9%). Default = 10³⁰
$Δ M_{\max}$	Total mass ratio criteria. Defined as the ratio of total mass at a given time divided by the initial 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.

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.