The NRG-Mobile respository contains source code for the execution and support of large area radiation survey tasks with an autonomous mobile robotics system. It is created under the copyright disclosure record C19007: "Nuclear Robotics Group: Autonomous Mobile Survey System." More information can be found in the LICENSE.md file.
The NRG-Mobile repository is divided into two metapackages:
- alpha_sweep - Contains packages specific to the execution of large area alpha radiation surveys by an autonomous mobile robot.
- robot_interface - Wrapper for robot driver commands in order to facilitate hardware agnostic operations.
- full_coverage - Primary operational package. First, generates a plan to navigate the robot in a way that fully covers the operation space. Second, executes coverage plan while maintaining safe conditions with respect to obstacles and radiation. Finally, outputs results of survey.
- sweep_gui - User facing graphical interface for interaction with the robot prior, during, and after survey task.
- navigation_tools - Contains packages that support generic navigation tasks in a semi-controlled environment.
- rolling_map - ROS-based tool for processing 3D sensor information into maps for complex path planning and obstacle avoidance in semi-structured environments.
- markers_to_map - Tool for the projection of 3D obstacle information into 2-dimensional images/maps for computationally efficient path planning.
- clear_area_recovery - Modified ROS navigation stack recovery behavior. For details see here.
- rotate_theta_recovery - Modified ROS navigation stack recovery behavior. For details see here.
- velodyne - Submodule for drivers to operate a Velodyne VLP-16 3D LIDAR.
- velodyne_orient - Tools to orient sensor information and clean the data for more efficient processing.
The NRG-Mobile project is dependent on ROS. ROS only runs in a Linux environment, nominally Ubuntu. The current version of NRG-Mobile supports ROS melodic. The following preliminary setup is required before downloading NRG-Mobile.
- Install Ubuntu 18.04. Many guides exist on this.
- Install ROS Melodic.
- Run the following command in the terminal interface to install other peripheral packages.
sudo apt install ros-melodic-navigation ros-melodic-octomap libcap0.8-dev git chrony
- Download this repository by entering the command below into the terminal.
git clone https://github.com/lanl/NRG-Mobile.git
git submodule update --init
- TODO: Finish section with any other package setup including scripts required
TODO: Please be patient as we work to create comprehensive guides.