How praveenelango/ros2-fast-stereo works
This ROS 2 workspace turns synchronized camera images into rectified stereo disparity, depth, and colored point clouds. The main path is camera configuration and projection, virtual-pinhole rectification, GPU stereo inference, then ROS publication; a parallel quad-stereo path batches four pairs for surround coverage. The graph also preserves the seven camera models and both configuration loaders. Relationships follow the README and SOURCE INDEX references; several implementation details are unsampled, so those connections are omitted rather than inferred.
Main entry points: camera.cpp Camera abstraction · ffs_node.cpp Stereo ROS node · quad_stereo_node.cpp Quad stereo node · stereo_depth_estimator.cpp TensorRT estimator
Components 22
Camera models
- Camera abstraction
src/camera_models/src/camera.cpp - Pinhole model
src/camera_models/src/pinhole_camera.cpp - Double Sphere model
src/camera_models/src/double_sphere_camera.cpp - Equirectangular model
src/camera_models/src/equirect_camera.cpp - Fisheye polynomial
src/camera_models/src/fisheye_poly_camera.cpp - Kannala Brandt 8
src/camera_models/src/kannala_brandt8_camera.cpp - Mei Omni model
src/camera_models/src/mei_omni_camera.cpp - Omni model
src/camera_models/src/omni_camera.cpp - ROS parameter loader
src/camera_models/src/ros_cam_cfg_loader.cpp - YAML loader
src/camera_models/src/yaml_cam_cfg_loader.cpp
Rectification
- Reprojection maps
src/perception_utils/src/reprojection.cpp - Virtual stereo pair
src/ffs_depth/src/stereo_pair.cpp
Stereo depth
- Stereo ROS node
src/ffs_depth/src/ffs_node.cpp - Frame queue
src/ffs_depth/include/ffs_depth/frame_queue.hpp - TensorRT estimator
src/ffs_depth/src/stereo_depth_estimator.cpp - Depth conversion
src/ffs_depth/include/ffs_depth/depth_kernel.hpp - Depth and cloud outputs
src/ffs_depth/src/ffs_node.cpp
Quad stereo
- Quad stereo node
src/ffs_depth/src/quad_stereo_node.cpp - Batched estimator
src/ffs_depth/src/quad_stereo_depth_estimator.cpp - Per-pair outputs
src/ffs_depth/src/quad_stereo_node.cpp
Other components
- ROS image sources
- TensorRT engine
Connections 25
- ROS image sources → Stereo ROS node: sends synchronized images
README.md - ROS image sources → Quad stereo node: sends four images
README.md - Stereo ROS node → ROS parameter loader: loads camera parameters
- Quad stereo node → ROS parameter loader: loads camera parameters
- ROS parameter loader → Camera abstraction: configures models
src/camera_models/src/camera.cpp - YAML loader → Camera abstraction: configures models
- Camera abstraction → Pinhole model: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Double Sphere model: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Equirectangular model: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Fisheye polynomial: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Kannala Brandt 8: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Mei Omni model: dispatches projection
src/camera_models/src/camera.cpp - Camera abstraction → Omni model: dispatches projection
src/camera_models/src/camera.cpp - Stereo ROS node → Virtual stereo pair: creates rectified pair
- Quad stereo node → Virtual stereo pair: creates rectified pairs
- Virtual stereo pair → Reprojection maps: precomputes remaps
- Stereo ROS node → Frame queue: enqueues frames
- Stereo ROS node → TensorRT estimator: runs inference
- TensorRT estimator → TensorRT engine: loads engine
README.md - TensorRT estimator → Depth conversion: converts disparity
src/ffs_depth/src/stereo_depth_estimator.cpp - Stereo ROS node → Depth and cloud outputs: publishes results
src/ffs_depth/src/ffs_node.cpp - Quad stereo node → Batched estimator: runs batched inference
- Batched estimator → TensorRT engine: loads batch engine
README.md - Batched estimator → Depth conversion: converts disparity
src/ffs_depth/src/quad_stereo_depth_estimator.cpp - Quad stereo node → Per-pair outputs: publishes pair results
src/ffs_depth/src/quad_stereo_node.cpp