/SENSOR/ENERGY

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

Format

(1)	(2)	(3)	(5)	(7)	(9)
/SENSOR/ENERGY/`sens_ID`/`unit_ID`
`sens_title`
`T`_delay
`part_ID`	`subset_ID`	`Iselect`
`IE`_min		`IE`_max	`KE`_min	`KE`_max	`T`_min
`IE`_tol		`IE`_time	`KE`_tol	`KE`_time

Definition

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 and `Iselect` = 1, internal and kinetic energy are from all meshed parts in the model. (Integer)
`Iselect`	Subset or global energy selector. = 1 (Default) Part and subset are used. Only energies for mesh parts are used. = 2 Gobal model energy is used (including energy from rigid walls, rigid bodies, and so on). (Integer)
`IE`_min	Minimum part or subset internal energy. Default = -1E+30 (Real)	$[J]$
`IE`_max	Maximum part or subset internal energy. Default = 1E+30 (Real)	$[J]$
`KE`_min	Minimum part or subset kinetic energy. Default = -1E+30 (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. (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. (Real)
`KE`_time	Minimum time duration for activation when constant kinetic energy is reached. Default = 1E+30 (Real)	$[s]$

Comments

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 around the mean value
- Kinetic energy is constant during KE_time with tolerance KE_tol around the mean value