Overview

Detects Pose Type for Person objects and using Pose keypoints if available.

Inputs & Outputs

Inputs : 1, Media Format : Raw Video
Outputs : 1, Media Format: Raw Video
Output Metadata : Pose information

Pipeline usage

Despite the historical node name, this node detects a fall from each selected object's bounding-box shape; it does not consume pose keypoints. Place a person detector and Track Objects upstream so the same object can remain over the threshold for min_pose_detection_time. A fall is detected when the box is sufficiently wider than it is tall, as controlled by threshold. Use ROIs to limit the monitored area, then trigger downstream actions from nodes.<node_id>.pose_fall_delta.

Properties

Property	Description	Type	Default	Required
`roi_labels`	Regions of interest labels	`string`	—	No
`rois`	Regions in which to look up pose. Conditional on `roi_labels`. Format: comma-separated normalized `x,y` coordinate pairs; separate multiple polygons with semicolons (for example, `0.1,0.1,0.9,0.1,0.9,0.9`).	`string`	`null`	No
`objects_to_track`	ex. `person`,`person.red`. Object types and classes used to detect pose. Leave blank to detect all poses.	model-labels	`null`	No
`min_pose_detection_time`	Min. detection time. Unit: seconds.	`float`	`0.0`	Yes
`threshold`	Declares person as fallen when width exceeds height by this factor. Range: minimum `0.0`, maximum `1.0`. Step: `0.05`.	`float`	`0.2`	No
`display_roi`	Display ROI on video?	`bool`	`true`	No
`display_objects`	Display objects on video?	`bool`	`true`	No

Output Metadata

The fields below are declared by this node's metadata schema; the JSON values are representative examples.

Path	Type	Description
`nodes.<node_id>.pose_fall_count`	`integer`	Number of detected fall poses in the current frame.
`nodes.<node_id>.pose_fall_delta`	`integer`	When one or more new objects are classified as falling
`nodes.<node_id>.type`	`string`	Identifies the node type that produced this metadata.

JSON example

{
  "nodes": {
    "detect_pose1": {
      "pose_fall_count": 0,
      "pose_fall_delta": 0,
      "type": "detect_pose"
    }
  }
}

Object labels and attributes

Object labels/classes added: None.
Object attribute labels/classes added: Detected pose labels, currently fall, use class 10900.