diff --git a/images/perception_camera.gif b/images/perception_camera.gif new file mode 100644 index 0000000..597a319 Binary files /dev/null and b/images/perception_camera.gif differ diff --git a/images/perception_depth.gif b/images/perception_depth.gif new file mode 100644 index 0000000..4a05130 Binary files /dev/null and b/images/perception_depth.gif differ diff --git a/images/perception_image.gif b/images/perception_image.gif new file mode 100644 index 0000000..9e925ff Binary files /dev/null and b/images/perception_image.gif differ diff --git a/images/perception_rviz.gif b/images/perception_rviz.gif new file mode 100644 index 0000000..f529a73 Binary files /dev/null and b/images/perception_rviz.gif differ diff --git a/perception.md b/perception.md index c241c35..c9b9100 100644 --- a/perception.md +++ b/perception.md @@ -1,22 +1,55 @@ -Help for the upright view, checkout out the /feature/upright_camera_view in the stretch_core package. +# Perception Introduction + +The Stretch robot is equipped with the Intel RealSense D435i camera, an essential component that allows the robot to measure and analyze the world around it. In this tutorial, we are going to showcase how to visualize the various topics published from the camera. + +Begin by switching your stretch_ros repository to the [feature/upright_camera_view](https://github.com/hello-robot/stretch_ros/tree/feature/upright_camera_view). The physical configuration of the camera results in the images being displayed sideways. Thus, this branch publishes a new topic that rotates the raw image upright. ```bash cd ~/catkin_ws/src/stretch_ros/stretch_core git checkout feature/upright_camera_view ``` +Then run the stretch driver launch file. ```bash +# Terminal 1 roslaunch stretch_core stretch_driver.launch ``` +To activate the RealSense camera and publish topics to be visualized, run the following launch file in a new terminal. + ```bash +# Terminal 2 roslaunch stretch_core d435i_low_resolution.launch ``` +Within this tutorial package, there is an RViz config file with the topics for perception already in the Display tree. You can visualize these topics and the robot model by running the command below in a new terminal. + ```bash +# Terminal 3 rosrun rviz rviz -d /catkin_ws/src/stretch_ros_tutorials/rviz/perception_example.rviz ``` + +
+ +
+ + ++ +
+ + ++ +
+ + ++ +
+ ```bash +# Terminal 4 rosrun stretch_core keyboard_teleop ```