https://github.com/tue-robotics/image_recognition
Packages for image recognition - Robocup TU/e Robotics
https://github.com/tue-robotics/image_recognition
face-recognition image-recognition openface robotics ros-wrapper skybiometry tensorflow
Last synced: 3 months ago
JSON representation
Packages for image recognition - Robocup TU/e Robotics
- Host: GitHub
- URL: https://github.com/tue-robotics/image_recognition
- Owner: tue-robotics
- License: mit
- Created: 2016-10-29T09:11:32.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-12-16T18:45:01.000Z (5 months ago)
- Last Synced: 2025-12-20T09:49:24.048Z (5 months ago)
- Topics: face-recognition, image-recognition, openface, robotics, ros-wrapper, skybiometry, tensorflow
- Language: Python
- Size: 23.9 MB
- Stars: 69
- Watchers: 14
- Forks: 40
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TU/e Robotics image_recognition
[](https://github.com/tue-robotics/image_recognition/actions/workflows/main.yml)
[](https://github.com/tue-robotics/image_recognition/actions/workflows/industrial_ci.yml)
Packages for image recognition - Robocup TU/e Robotics
## Package status & Description
Package | Build status Xenial Kinetic x64 | Description
------- | ------------------------------- | -----------
[image_recognition](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition) | [](http://build.ros.org/job/Ksrc_uX__image_recognition__ubuntu_xenial__source/1/) | Meta package for all image_recognition packages.
[image_recognition_analysis](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_analysis) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_analysis__ubuntu_xenial__source/1/) | analysis for image recognition
[image_recognition_color_extractor](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_color_extractor) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_color_extractor__ubuntu_xenial__source/1/) | Extract dominant colors from images
[image_recognition_jetson](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_jetson) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_jetson_ubuntu_xenial__source/1/) | ROS wrapper for Jetson Inference (https://github.com/dusty-nv/jetson-inference) for running inference using TensorRT.
[image_recognition_keras](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_keras) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_keras_ubuntu_xenial__source/1/) | ROS wrappers for Keras neural nets.
[image_recognition_msgs](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_msgs) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_msgs__ubuntu_xenial__source/1/) | Interface definition for image recognition
[image_recognition_openface](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_openface) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_openface__ubuntu_xenial__source/1/) | ROS wrapper for Openface (https://github.com/cmusatyalab/openface) to detect and recognize faces in images.
[image_recognition_openpose](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_openpose) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_openpose_ubuntu_xenial__source/1/) | ROS wrapper for Openpose (https://github.com/CMU-Perceptual-Computing-Lab/) for getting poses of 2D images.
[image_recognition_pytorch](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_pytorch) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_pytorch_ubuntu_xenial__source/1/) | ROS wrapper around a PyTorch model for (https://github.com/Nebula4869/PyTorch-gender-age-estimation) for getting age & gender estimations on faces
[image_recognition_rqt](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_rqt) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_rqt__ubuntu_xenial__source/1/) | RQT tools with helpers testing this interface and training/labeling data.
[image_recognition_skybiometry](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_skybiometry) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_skybiometry_ubuntu_xenial__source/1/) | ROS wrapper for Skybiometry (https://skybiometry.com/) for getting face properties of a detected face, e.g. age estimation, gender estimation etc.
[image_recognition_tensorflow](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_tensorflow) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_tensorflow__ubuntu_xenial__source/1/) | Object recognition with use of Tensorflow. The user can retrain the top layers of a neural network to perform classification with its own dataset as described in [this tutorial](https://www.tensorflow.org/versions/r0.11/how_tos/image_retraining/index.html).
[image_recognition_tensorflow_rqt](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_tensorflow_rqt) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_tensorflow_rqt__ubuntu_xenial__source/1/) | RQT tools for retraining a Tensorflow neural network.
[image_recognition_util](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_util) | [](http://build.ros.org/job/Ksrc_uX__image_recognition_util__ubuntu_xenial__source/1/) | Utils shared among image recognition packages
# How to
## Object recognition
Step 1: label images with the [image_recognition_rqt#annotation-plugin](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_rqt#annotation-plugin)
[](http://www.youtube.com/watch?v=uAQvn7SInlg)
<-- Youtube video
Step 2: train a neural network with the [image_recognition_tensorflow_rqt](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_tensorflow_rqt)
[](http://www.youtube.com/watch?v=6JdtWa8FD04)
<-- Youtube video
Step 3: predict labels for new data with the [image_recognition_rqt#test-plugin](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_rqt#test-plugin)
[](http://www.youtube.com/watch?v=OJKYLB3myWw)
<-- Youtube video
## Face recognition
See the tutorial at [image_recognition_openface](https://github.com/tue-robotics/image_recognition/tree/master/image_recognition_openface)
[](http://www.youtube.com/watch?v=yGqDdfYxHZw)
<-- Youtube video
# Installation
Clone the repo in your catkin_ws:
cd ~/catkin_ws/src
git clone https://github.com/tue-robotics/image_recognition.git
Build your catkin workspace
cd ~/catkin_ws
catkin_make