hri_face_body_matcher

Overview

hri_face_body_matcher is a ROS4HRI-compatible face to body matcher node.

It finds the most likely matches between the recognized faces and bodies based on their relative position in the source image.

Algorithm

For each of the possible associations of recognized face and body, a matching cost is computed, linearly decreasing with the distance between the body nose and the face center in the image.

The rate the confidence drops is proportional to the ~confidence_scaling_factor parameter and the face size, intended as its diagonal length.

confidence = max(0, 1 - \frac{distance * c.s.f.}{2 * face\ size})

ROS API

Parameters

All parameters are loaded in the lifecycle configuration transition.

• ~confidence_threshold (double ∈ [0,1], default: 0.5): Candidate matches with confidence lower that this threshold are not published.

• ~confidence_scaling_factor (double > 0, default: 2.0): Factor scaling how quickly the estimated confidence drops as the distance between the matched face and body increases.

Topics

This package follows the ROS4HRI conventions (REP-155). If the topic message type is not indicated, the ROS4HRI convention is implied.

Subscribed

• /humans/bodies/tracked
• /humans/bodies/<body_id>/skeleton2d
• /humans/faces/tracked
• /humans/faces/<face_id>/roi

Published

• /humans/candidate_matches

Execution

ros2 launch hri_face_body_matcher hri_face_body_matcher.launch.py

Example

For an example of usage, execute in different terminals:

• USB camera:
  1. apt install ros-humble-usb-cam
  2. ros2 run usb_cam usb_cam_node_exe
• HRI face detect:
  1. Either
     • if you are on a PAL robot apt install ros-humble-hri-face-detect
     • otherwise build and install from source.
  2. ros2 launch hri_face_detect face_detect.launch.py
• HRI fullbody:
  1. Either
     • if you are on a PAL robot apt install ros-humble-hri-fullbody
     • otherwise build and install from source.
  2. ros2 launch hri_fachri_fullbody hri_fullbody.launch.py
• HRI face body matcher:
  1. apt install ros-humble-hri-face-body-matcher
  2. ros2 launch hri_face_body_matcher hri_face_body_matcher.launch.py
• RViz with HRI plugin:
  1. apt install ros-humble-rviz2
  2. Either
     • if you are on a PAL robot apt install ros-humble-hri-rviz
     • otherwise build and install from source.
  3. rviz2

In RViz, add the ‘Humans’ plugin to see the detected faces. The face IDs should be permanently assigned to the same people.

Changelog for package hri_face_body_matcher

2.1.0 (2024-11-19)

• re-license as Apache 2.0
• Contributors: Séverin Lemaignan

2.0.3 (2024-09-16)

• make pal_module_cmake an optional dependency
• Contributors: Séverin Lemaignan

2.0.2 (2024-08-20)

• publish basic diagnostics
• Contributors: Séverin Lemaignan

2.0.1 (2024-04-24)

• add pal module
• Contributors: Luka Juricic

2.0.0 (2024-02-14)

• add example in README
• bump copyright year; increase version; fix README
• port test to ros 2 humble
• port node and launch file to ros 2 humble
• Contributors: Luka Juricic

0.1.5 (2023-07-06)

• use development sqlite3 dependency
• Contributors: Luka Juricic

0.1.4 (2023-07-06)

• add sqlite3 dependency
• Contributors: Luka Juricic

0.1.3 (2023-07-05)

• change RoI message type to hri_msgs/NormalizedRegionOfInterest2D
• fix tests reliability
• align test file structure
• Contributors: Luka Juricic

0.1.2 (2023-06-21)

• add missing blas dependency to package.xml
• tweak CMakeLists to please the buildfarm debian generation
• Contributors: Séverin Lemaignan

0.1.1 (2023-06-20)

• add explicit dependency on BLAS
• Contributors: Séverin Lemaignan

0.1.0 (2023-06-16)

• README line wrapping
• first implementation
• Initial commit
• Contributors: Luka Juricic, Séverin Lemaignan, lukajuricic