Utilization and Occupancy

What is the difference between Utilization and Occupancy?

There are many different definitions of utilization and occupancy, but in Yanzi products we use Utilization to describe the number of used resources in a space (eg 3 used desks of 4 in a space). Occupancy is the binary answer whether any resource is used or not.

As an example: A single person occupies a 10-seat conference room for a full day. The occupancy was 100% (the room was used all the time) but utilization was 10% (only one of ten chairs was used)

What kind of utilization/occupancy data is available in the platform?

VariableName	Available on	Description
inputMotion	Motion sensor	Counter incremented every time the sensor sees motion.
assetState	Motion sensor	Shows "motion" for at least 15 seconds after each motion event. Then a noMotion event is sent (unless motion continues)
assetState	All digital twins	Indicates occupied/free (or offline) every time the occupied/free state changes. The twin goes occupied immediately but has a 5 minute timeout without any motion before it returns to free.
assetUtilization	All digital twins	Indicates the number of free/occupied (and offline) devices in the hierarchy below the twin. For instance, a conference room with three occupied desks and two free will indicate all these numbers in the Sample.

Why cant i configure the timeout on the occupied state?

The goal of the yanzi implementation is to cover the common use case for occupancy without making it complicated. Depending on customer preference and application however, you might want to handle occupancy differently. In that case, you can always subscribe to the raw motion events to implement custom handling of occupancy state.