Houdini 20.5 Nodes Geometry nodes

Labs ML CV Keypoint Metadata 1.0 geometry node

Prepares the keypoint metadata.

On this page
Since 20.5

This node takes in a set of points and prepares the keypoint metadata to be exported to the COCO JSON file by the Labs ML CV ROP Annotation Output SOP.

Note

Each input point must have a unique string attribute kp_name. (The prefix kp stands for keypoint.)

The original ML Computer Vision tools were developed by the Synthetic Data team at Endava PLC.

Parameters

Render

Camera LOP Path

The path to the LOP node from which the camera primitive is sourced.

Camera Primitive

The USD primitive path that points to the camera, used for obtaining screen space coordinates of the keypoints.

Camera Resolution

The camera resolution. Defaults to @res, a PDG attribute created by the Labs ML CV ROP Synthetic Data TOP.

Compute Ground Truth

Enables the calculation of ground truth for keypoint positions (both screen-space and global). This is useful when separating this node’s functions and computing ground truth further downstream.

Include Keypoint 3D Metadata

Adds keypoint 3D Metadata to the COCO JSON file exported by the Labs ML CV ROP Annotation Output SOP.

Skeleton Metadata

Include Skeleton Connectivity

Enables the creation of the skeleton connectivity map. This connectivity is used to optionally generate a skeleton from keypoints and is useful for visualizing results within the ML training pipeline.

Visualize Connectivity

Enables the creation of edges between skeleton points that will be connected in the Ground Truth, allowing preview of this connectivity in the Houdini viewport.

Skeleton Connections

The list of ordered pair point connections separated by commas, for example: [0,1],[1,2].

Add Connections

Creates the connections multiparm from the Skeleton Connections parameter and input points.

Connections

The number of skeleton connections.

Skeletons

Connection

The ordered pair for defining the skeleton connection.

Skeleton Weight

The importance of the skeleton link between keypoints.

Skeleton Color

The color of the skeleton connection. (This is not visualized in the Houdini viewport).

Keypoint Metadata

Assign Keypoint Metadata

Enables the creation of keypoint metadata by this node.

Assign Point Colors

Enables the assignment of colors to the keypoints.

Add Input Keys

Generates the Keypoints multiparm based on the input points.

Keypoints

The number of keypoints.

Keypoints

Keypoint ID

The index of the keypoint. This number cannot be 0. The ID value defaults to the point number plus 1.

Keypoint Name

The name of the keypoint, initially set by the attribute kp_name.

Keypoint Sigma

The weight used in the Object Keypoint Similarity (OKS) calculation during evaluation, adjusted to indicate the expected precision of the model.

Keypoint Color

The color of the Keypoint for ML visualization

Keypoint Type

Defines the type of the keypoint, used for grouping multiple keypoints. For example, all keypoints of a left hand would have the type 'hand'.

Swapable

Specifies the mirror point for each keypoint, if one exists (e.g., 'elbow_left', 'elbow_right'). This is useful for data augmentation when flipping the image horizontally.

Examples

Tip

When viewing in Houdini’s Help Browser, please copy the example file’s URL to a regular browser to proceed with the download.

See also

Geometry nodes