/KILL

Engine Keyword The Engine is stopped and restart files are not created, 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
           

Definition

Field Contents SI Unit Example
Emax 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 NERR_POSIT =1.

Default = 1030

 
Δ M max MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaaeiLdiaad2 gadaWgaaWcbaGaciyBaiaacggacaGG4baabeaaaaa@3B02@ 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 = 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. Energy error ratio:(1)
    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 MathType@MTEF@5@5@+= feaagKart1ev2aaatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaaeaaaaaaaaa8 qadaWcaaWdaeaapeGaamyra8aadaWgaaWcbaWdbiaadUgaa8aabeaa k8qacqGHRaWkcaWGfbWdamaaDaaaleaapeGaam4AaaWdaeaapeGaam OCaaaakiabgUcaRiaadweapaWaaSbaaSqaa8qacaWGPbaapaqabaaa keaapeGaamyra8aadaWgaaWcbaWdbiaadUgacaGGSaGaaGymaaWdae qaaOWdbiabgUcaRiaadweapaWaa0baaSqaamaaBaaameaapeGaam4A aiaacYcacaaIXaaapaqabaaaleaapeGaamOCaaaakiabgUcaRiaadw eapaWaaSbaaSqaa8qacaWGPbGaaiilaiaaigdaa8aabeaak8qacqGH RaWkcaWGfbWdamaaBaaaleaapeGaam4DaiaadUgaa8aabeaak8qacq GHsislcaWGfbWdamaaBaaaleaapeGaam4DaiaadUgacaGGSaGaaGym aaWdaeqaaaaak8qacqGHsislcaaIXaaaaa@587C@
    Where,
    E k MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamyramaaBa aaleaacaWGRbaabeaaaaa@37DD@
    Translational kinetic energy at current time.
    E k r MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamyramaaDa aaleaacaWGRbaabaGaamOCaaaaaaa@38D5@
    Rotational kinetic energy at current time.
    E i MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamyramaaBa aaleaacaWGPbaabeaaaaa@37DB@
    Internal energy.
    E wk MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamyramaaBa aaleaacaWG3bGaam4Aaaqabaaaaa@38D9@
    Work of external forces (energy brought to the system).
    E ,1 MathType@MTEF@5@5@+= feaagKart1ev2aqatCvAUfeBSjuyZL2yd9gzLbvyNv2CaerbuLwBLn hiov2DGi1BTfMBaeXatLxBI9gBaerbd9wDYLwzYbItLDharqqtubsr 4rNCHbGeaGqiVu0Je9sqqrpepC0xbbL8F4rqqrFfpeea0xe9Lq=Jc9 vqaqpepm0xbba9pwe9Q8fs0=yqaqpepae9pg0FirpepeKkFr0xfr=x fr=xb9adbaqaaeGaciGaaiaabeqaamaabaabaaGcbaGaamyramaaBa aaleaacaGGSaGaaGymaaqabaaaaa@3858@
    Energy at beginning of the RUN (not at time t=0).
  2. 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.
  3. The total mass criteria is defined as the ratio of total added mass at a given time divided by the initial total mass.
  4. 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.
  5. No restart file is written, if the Engine is stopped, due to one of these events (to write a Restart file, use /STOP).