App Stack
People Occupancy

People Occupancy

People Occupancy is used to monitor and count the number of people present within a defined area or frame.

People Occupancy Dashboard

1. Finding the People Occupancy Application in App Stack

  1. Open App Stack on the platform.
  2. Use the search bar (usually at the top right of the dashboard).
  3. Enter People Occupancy.
  4. In the results, click once on the application to open it.

Search People Occupancy

2. Device Configuration

After the application opens, you are taken to the Device Configuration page.

  • On the right side of the page, use the option to add a device and connect the cameras you need.
  • When finished, continue to the next step (ROI Configuration).

Device Configuration

3. ROI (Region of Interest) Configuration

All devices you added on the device configuration step appear here so you can draw ROIs on the correct feeds.

  1. Select the device you want to configure.
  2. Click Add ROI (top right of the ROI Configuration page).
  3. Fill in the ROI details:

ROI Configuration

FieldGuidance for People Occupancy
ROI NameEnter a clear name for the region.
ROI ColorPick a color to distinguish this ROI on the video.
ROI TypeSelect Junction as the ROI type.
ROI ClassesNot required.

Note: Without an ROI, this application will also run.

4. Meta Parameters Configuration

After ROI setup, open the Meta Parameters page.

Meta Parameters

4.1 Default vs. custom configuration

You can either:

  • Use a default configuration, or
  • Create a new custom configuration.

A default configuration typically includes these modules in the flow:

  • Device
  • People Detection
  • Region of Interest (ROI)
  • Event
  • Alert

Default Configuration

4.2 Device module

  • Click on the device node.
  • Select the desired devices.

Available settings include:

Enable SAHI

  • Used for processing large frames.
  • Divides large images into smaller chunks to improve detection of people who appear far from the camera.
  • Recommended for high-resolution or wide-area coverage cameras.

Duration

  • Defines the time interval (in seconds) after which a new detection event is generated.
  • Configured camera-wise.
  • Helps control repeated detections for the same instance.

4.3 People Detection node

  • Confidence Threshold
    • The default value is 0.45.
    • Can be adjusted based on the deployment scenario and camera conditions.

4.4 Final configuration

  • Select the required device and associated ROI.
  • Configure parameters if needed.
  • Enter a name for this configuration.
  • Choose hardware type (CPU or GPU) to match your server.
  • Adjust batch size if required (as per development/CV team recommendation).

The following settings are applicable only if face detection is required:

IS_Face

ValueBehavior
1Enables face detection along with people detection
0Detects only people (default)

Blob Size

  • Defines the size at which the model detects faces.
  • Common default value: 640

Note: If face detection is not required:

  • Keep IS_Face = 0
  • Keep Blob Size = 640 (default)

When everything is set, click Save.

Your People Occupancy configuration is now ready to use.