/SENSOR/ENERGY

Block Format Keyword Describes the sensors used to activate or deactivate an object according to energy.

Format

Field	Contents	SI Unit Example
`sens_ID`	Sensor identifier. (Integer, maximum 10 digits)
`unit_ID`	Optional unit identifier. (Integer, maximum 10 digits)
`sens_title`	Sensor title. (Character, maximum 100 characters)
`T`_delay	Time delay. (Real)	$[s]$
`part_ID`	Part identifier for the part monitored for /SENSOR/ENERGY. (Integer)
`subset_ID`	Subset identifier for the subset monitored for /SENSOR/ENERGY, used if `part_ID` is not defined. If `part_ID` and `subset_ID` are not defined, global internal and kinetic energy are used. (Integer)
`IE`_min	Mininum part or subset internal energy. Default = 0 (Real)	$[J]$
`IE`_max	Maximum part or subset internal energy. Default = 1E+30 (Real)	$[J]$
`KE`_min	Minimum part or subset kinetic energy. Default = 0 (Real)	$[J]$
`KE`_max	Maximum part or subset kinetic energy. Default = 1E+30 (Real)	$[J]$
`T`_min	Minimum time duration before activation when criteria is reached. 5 (Real)	$[s]$
`IE`_tol	Tolerance for constant internal energy definition. Default = 0.05 (Real)
`IE`_time	Minimum time duration for activation when constant internal energy is reached. Default = 1E+30 (Real)	$[s]$
`KE`_tol	Tolerance for constant kinetic energy definition. Default = 0.05 (Real)
`KE`_time	Minimum time duration for activation when constant kinetic energy is reached. Default = 1E+30 (Real)	$[s]$

Sensors can be used to activate airbags, imposed forces, pressures, and fixed velocities.
Sensors can be used to activate or deactivate these elements with /ACTIV.
Sensors can be used to generate animations or h3d frames at specific conditions with the Engine keywords /ANIM/LSENSOR or /H3D/LSENSOR.
Sensors can be used to terminate a simulation at specific conditions with the Engine keyword /STOP/LSENSOR.
For sensor type ENERGY.
The sensor is activated when the internal or kinetic energies satisfy the criteria for the defined part or subset.
- Internal energy < IE_min or Internal energy > IE_max during time > T_min
- Kinetic energy < KE_min or Kinetic energy > KE_max during time > T_min
- Internal energy is constant during IE_time with tolerance IE_tol
- Kinetic energy is constant during KE_time with tolerance KE_tol
IE_tol is defined as standard deviation divided by mean value, both based on exponential average over time interval IE_time.
KE_tol is defined as standard deviation divided by mean value, both based on exponential average over time interval KE_time.