Pose Estimation

Estimates a person's pose in real time from the camera video and provides the coordinates of 17 key points (joints). Distances between key points and joint angles can be computed directly.

Commands

Command	Description
Person Detected?	Checks whether a person is detected.
Get Keypoint	Writes the coordinates and confidence of the specified key point (e.g. wrist, knee).
Distance Between Keypoints	Writes the pixel distance between two key points.
Joint Angle	Computes and writes the angle of a joint formed by three key points (e.g. the elbow angle).
Keypoint Exists in Zone	Checks whether the specified key point lies inside the Detection Zone.
Get All Keypoints	Writes the coordinates of all 17 key points as JSON.

Settings

Setting	Description
Key Point	The key point whose coordinates are read or whose presence in the zone is checked. One of 17.
Key Point 1 / Key Point 2	The two key points whose distance is computed.
Joint	The joint whose angle is computed: Left Elbow, Right Elbow, Left Shoulder, Right Shoulder, Left Knee, Right Knee, Left Hip, Right Hip, Spine Tilt, or Neck Tilt.
Detection Zone	See Common Items.

Output Variables

Field	Type	Value
Detected	Digital	Result of Person Detected?, Get Keypoint, and Keypoint Exists in Zone.
Key Point X / Key Point Y	Number	Pixel coordinates of the specified key point.
Confidence (%)	Number	Confidence of the specified key point, 0 to 100.
Detected	Digital	For Distance Between Keypoints and Joint Angle: true when both key points (the joint) were detected and the value was computed.
Joint Angle (°)	Number	Angle of the specified joint.
Distance (pixels)	Number	Distance between the two key points.
Output (JSON Text)	Text	Array of the 17 key points.

JSON Output

An array with, per key point, id, name, x, y, and confidence (0 to 100). The sample shows only a few entries.

[
  { "id": 0, "name": "nose", "x": 320, "y": 180, "confidence": 95 },
  { "id": 5, "name": "left_shoulder", "x": 280, "y": 260, "confidence": 91 },
  { "id": 6, "name": "right_shoulder", "x": 360, "y": 258, "confidence": 93 },
  { "id": 15, "name": "left_ankle", "x": 270, "y": 470, "confidence": 78 }
]

The 17 key points

ID	JSON name	Shown as
0	nose	Nose
1	left_eye	Left Eye
2	right_eye	Right Eye
3	left_ear	Left Ear
4	right_ear	Right Ear
5	left_shoulder	Left Shoulder
6	right_shoulder	Right Shoulder
7	left_elbow	Left Elbow
8	right_elbow	Right Elbow
9	left_wrist	Left Wrist
10	right_wrist	Right Wrist
11	left_hip	Left Hip
12	right_hip	Right Hip
13	left_knee	Left Knee
14	right_knee	Right Knee
15	left_ankle	Left Ankle
16	right_ankle	Right Ankle