Skip to content
Important! Yanzi IoT product line will be sunsetted end of 2025. Click here to learn more.

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?

Occupancy data diagram Occupancy data diagram

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.