/KILL

Engine Keyword The Engine is stopped if one of the following criteria is exceeded.

Format

/KILL

Emax Δ M max MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaeiLdiaad2 gadaWgaaWcbaGaciyBaiaacggacaGG4baabeaaaaa@3B02@ Δ N max MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaeiLdiaad2 gadaWgaaWcbaGaciyBaiaacggacaGG4baabeaaaaa@3B02@ NTH NANIM NERR_POSIT

Definitions

Field Content SI Unit Example
Emax 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 = 1030

  
Δ M max MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaeiLdiaad2 gadaWgaaWcbaGaciyBaiaacggacaGG4baabeaaaaa@3B02@ Total mass ratio criteria is defined as the total added mass at a given time divided by the initial total mass.

Default = 1030

  
Δ N max MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaeiLdiaad2 gadaWgaaWcbaGaciyBaiaacggacaGG4baabeaaaaa@3B02@ Nodal mass ratio criteria is defined for each node as its mass divided by its initial mass. The computation is stopped, if at least one node meets the criteria.

Default = 1030

  
NTH
= 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.
  
NANIM
= 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.
  
NERR_POSIT
= 0 (Default)
The Engine is stopped when the absolute value of the energy error is more than Emax.
= 1
Only positive energy error is checked for stopping the Engine. Engine is stopped when the energy error is more than Emax.
  

Comments

  1. 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 NERR_POSIT = 1, NTH = 1, NANIM = 1, and a relatively low value for Emax.
  2. The total mass criteria is defined as the ratio of total added mass at a given time divided by the initial total mass.
  3. 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.
  4. No restart file is written if the Engine is stopped due to one of these events (to write a Restart file, use /STOP).