Repository Summary
Checkout URI | https://github.com/peter-nebe/stair-step-detector.git |
VCS Type | git |
VCS Version | master |
Last Updated | 2024-01-02 |
Dev Status | DEVELOPED |
CI status | No Continuous Integration |
Released | UNRELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
example_subscriber_pkg | 0.0.1 |
stair_step_detector_pkg | 0.0.1 |
stairs_msg | 0.0.1 |
stairs_visualizer_pkg | 0.0.1 |
README
stair-step-detector
Detection of stair steps using a LiDAR depth camera
Dependencies
- Intel RealSense SDK
- OpenCV
- OpenGL
- Boost
- ROS (only for the ROS2 wrapper)
Overview
The camera is calibrated with the help of three points in the ground plane. There is more information about calibration here.
After calibration, the camera can measure the heights and corner points of the stair steps that are in the measurement area. External world coordinates are displayed on the left.
Knowing the exact positions of the individual steps can help a mobile robot to negotiate stairs, if it is able to do so in principle. For a robot, ascending and descending stairs may be different challenges. But there is only one position and line of sight for the camera to fully capture a step. If the camera is attached to the robot, it must always be brought into the correct measuring position using suitable mechanics. In principle it could look like this:
If the robot is clever, it ensures that the image is not upside down by rotating the camera 180 degrees around the optical axis. If it doesn’t, the image has to be rotated (or mirrored) using software. Then the algorithm of the stair-step-detector can be used for both ascending and descending stairs.
The camera used
The stair-step-detector currently uses the Intel® RealSense™ LiDAR Camera L515. The depth accuracy of the L515 is better than that of the RealSense stereo cameras. But there can be many reasons why someone might want to use the stair-step-detector with a different camera, from RealSense or another manufacturer. In principle, any depth camera can be used. For this purpose, at least the class Camera must be adapted, and depending on the features of the camera in question, additional classes. The least effort is to be expected with another RealSense camera, because the RealSense SDK can then also be used. The stair-step-detector depends on the L515 and the RealSense SDK in the following way:
- An infrared image and the associated depth image are taken for the geometric calibration.
- The calibration marks are localized in the infrared image, and the 3D coordinates are determined for these 2D positions.
- In measurement mode, the SDK delivers point clouds in distortion-free Cartesian coordinates.
- For the sake of simplicity, the window class from the SDK examples is used for the application window.
The adaptation effort would be greatest when using two conventional cameras as a stereo pair, but thanks to OpenCV that is also possible in principle.
Integration with ROS
If you are familiar with the Robot Operating System, you can use the simple wrapper for ROS2 Galactic Geochelone. Among other things, it contains a ROS package with which the measured stair steps can be visualized. The display is done with RViz, the 3D visualization tool for ROS. Here you can see an example:
See ROS Wiki for more details.
MDE
It becomes even more convenient: If you are interested in Model-Driven Engineering (MDE), you can use the model of the stair-step-detector. You can combine this with other ROS components and create an ROS system without manual coding. The code generation is done by sophisticated and advanced tools.
Diagram of an exemplary ROS system
You can find the tools you need here: https://github.com/ipa320/ros-model