This repository contains all the code required to use both the simulated and real RealSense cameras with ROS. The simulated camera is implemented in Gazebo. It contains the following submodules:
It currently contains the gazebo implementation for the:
Feel free to add a pull_request/issue might you need support for any of the other cameras.
To use this package, you first have to make sure you installed the required Realsense libraries. A guide on how this is done can be found in the realsense documentation. Additionally you also have to make sure ROS and Gazebo are installed.
In order to build the package you have to create a catkin workspace. You can then clone the repository in the src folder using the following command:
mkdir ~/catkin_ws
cd ~/catkin_ws
git clone --recurse-submodules src
Please make sure you use the --recursive-submodules
flag as this repository contains submodules. After you cloned the repository you can install the ros dependencies using the following command:
rosdep install --from-paths src --ignore-src --rosdistro melodic
When this is done you can build the package using one of the following commands:
catkin_make
catkin build
To see the package in action source the catkin ./devel/setup.bash
script. An example can then be started using the following command:
roslaunch realsense2_description view_d435_model_rviz_gazebo.launch
This repository was created following the guide on the realsense2_description repository of @issaiass
Feel free to open an issue if you have ideas on how to make this GitHub action better or if you want to report a bug! All contributions are welcome. 🚀 Please consult the contribution guidelines for more information.