State

A state transmits high-level information about the scene or setup. The information it contains depends on the configuration. States will get calculated on every frame of measurement.

Table 1. Available fields in blickfeld.percept_processing.data.State
Field	Type	Default	Unit
generator_name	string	-	-
generator_name	The name of the entity generating this state
security	Security	-	-
security	The security state contains intrusion information of a zone
volume	Volume	-	-
volume	Current volume measured in the selected zone
object_based_security	ObjectBasedSecurity	-	-
object_based_security	The object based security state contains intrusion information of a zone and the objects that trigger the intrusion
occupancy	Occupancy	-	-
occupancy	The state contains occupation information of a zone
traversal_security	TraversalSecurity	-	-
traversal_security	The traversal state

Object Based Security

A message containing an alarm state of a zone.

Table 2. Available fields in blickfeld.percept_processing.data.State.ObjectBasedSecurity
Field	Type	Default	Unit
alarm	bool	-	-
alarm	If there is an alarm or not in the zone.
objects	repeated ObjectsEntry	-	-
objects	Map of objects where the key is the UUID of the object that triggered the alarm.
intrusion	Flag	-	-
intrusion	Active intrusion. Can be used as pre-alarm.
intrusion_confidence	float	-	-
intrusion_confidence	Confidence that it is a real intrusion. Calculates a moving average of the intrusion state. The moving average window size can be configured with the minimum intruding duration parameter.

Objects Entry

Table 3. Available fields in blickfeld.percept_processing.data.State.ObjectBasedSecurity.ObjectsEntry
Field	Type	Default	Unit
key	string	-	-
value	DetectedObject	-	-

Security

A message containing an alarm state of a zone.

Table 4. Available fields in blickfeld.percept_processing.data.State.Security
Field	Type	Default	Unit
alarm	bool	-	-
alarm	If there is an alarm or not in the zone.
num_detected_points	uint32	-	-
num_detected_points	The current number of lidar points detected in the zone.
point_cloud	core_processing.data.Frame	-	-
point_cloud	Foreground point cloud inside zone which triggered the alarm.
intrusion	Flag	-	-
intrusion	Active intrusion. Can be used as pre-alarm.
intrusion_confidence	float	-	-
intrusion_confidence	Confidence that it is a real intrusion. Calculates a moving average of the intrusion state. The moving average window size can be configured with the minimum intruding duration parameter.

Volume

A message containing the volume state of a zone. This is based on one volume zone.

Table 5. Available fields in blickfeld.percept_processing.data.State.Volume
Field	Type	Default	Unit
volume	float	-	m^3
volume	The current numerical volume of the zone.
coverage	float	-	-
coverage	The current zone volume surface coverage

Occupancy

A message containing the occupancy state of a zone.

Table 6. Available fields in blickfeld.percept_processing.data.State.Occupancy
Field	Type	Default	Unit
occupied	bool	-	-
occupied	True if the zone is occupied.
num_detected_points	uint32	-	-
num_detected_points	The current number of lidar points detected in the zone.
baseline	float	-	-
baseline	Current baseline.

Traversal Security

A message containing the traversal state of a zone.

Table 7. Available fields in blickfeld.percept_processing.data.State.TraversalSecurity
Field	Type	Default	Unit
alarm	bool	-	-
alarm	The traversal alarm
objects	repeated ObjectsEntry	-	-
objects	The objects which triggered the inbound alarm
intrusion	Flag	-	-
intrusion	Active traversal

Objects Entry

Table 8. Available fields in blickfeld.percept_processing.data.State.TraversalSecurity.ObjectsEntry
Field	Type	Default	Unit
key	string	-	-
value	DetectedObject	-	-