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

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

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).

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.
- Select the device you want to configure.
- Click Add ROI (top right of the ROI Configuration page).
- Fill in the ROI details:

| Field | Guidance for People Occupancy |
|---|---|
| ROI Name | Enter a clear name for the region. |
| ROI Color | Pick a color to distinguish this ROI on the video. |
| ROI Type | Select Junction as the ROI type. |
| ROI Classes | Not required. |
Note: Without an ROI, this application will also run.
4. Meta Parameters Configuration
After ROI setup, open the Meta Parameters page.

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

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
| Value | Behavior |
|---|---|
| 1 | Enables face detection along with people detection |
| 0 | Detects 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.