Getting Started¶
Note
You are on the latest ROS Melodic version of the tutorials, which is less stable. For beginners we recommmend the more stable ROS Kinetic tutorials (Requires Ubuntu 16.04). For older computers on Ubuntu 14.04 see ROS Indigo tutorials with the PR2.
Install ROS and Catkin¶
Install ROS Melodic. It is easy to miss steps when going through the ROS installation tutorial. If you run into errors in the next few steps, a good place to start is to go back and make sure you have installed ROS correctly.
Once you have ROS installed, make sure you have the most up to date packages:
rosdep update
sudo apt-get update
sudo apt-get dist-upgrade
Install catkin the ROS build system:
sudo apt-get install ros-melodic-catkin python-catkin-tools
Install MoveIt!¶
The simplest way to install MoveIt! is from pre-built binaries (Debian):
sudo apt install ros-melodic-moveit
Advanced users might want to install MoveIt! from source.
Download the Example Code¶
Within your catkin workspace, download the tutorials as well as the panda_moveit_config package:
cd ~/ws_moveit/src
git clone https://github.com/ros-planning/moveit_tutorials.git -b melodic-devel
git clone https://github.com/ros-planning/panda_moveit_config.git -b melodic-devel
Note
For now we will use a pre-generated panda_moveit_config package but later we will learn how to make our own in the MoveIt! Setup Assistant tutorial.
Build your Catkin Workspace¶
The following will install from Debian any package dependencies not already in your workspace:
cd ~/ws_moveit/src
rosdep install -y --from-paths . --ignore-src --rosdistro melodic
The next command will configure your catkin workspace:
cd ~/ws_moveit
catkin config --extend /opt/ros/${ROS_DISTRO} --cmake-args -DCMAKE_BUILD_TYPE=Release
catkin build
Source the catkin workspace:
source ~/ws_moveit/devel/setup.bash
Optional: add the previous command to your .bashrc:
echo 'source ~/ws_moveit/devel/setup.bash' >> ~/.bashrc
Note
Sourcing the setup.bash automatically in your ~/.bashrc is not required and often skipped by advanced users who use more than one catkin workspace at a time, but we recommend it for simplicity.
Open Source Feedback
See something that needs improvement? Please open a pull request on this GitHub page