|Title:||ROS Indigo and Newer Metapackages|
|Author:||Tully Foote <tfoote at openrobotics.org>|
This REP describes the metapackages for the ROS Indigo release and for releases that follow until otherwise replaced by a similar update REP. This REP updates REP 131  for changes in packages.
For a discussion on the general motivation and role of variants, please see REP 108 .
As of ROS Hydro we have completed the transition to using metapackages instead of variants. For more information on metapackages see REP 127 .
This document covers the common metapackages used for recommended installations. It is expressed in the ros/metapackages repository on github.com .
This REP proposes the same entrypoints as REP 108 and merely updates the variant definitions to reflect the organizational changes in ROS stacks.
The definitions in this REP are more focused and concise for clearer purpose, and do not list all transitive dependencies explicitly.
We define the same three main entry points for ROS users as REP 108 .
- desktop_full (recommended)
The ros_core metapackage composes the core communication protocols. It may not contain any GUI dependencies. In ROS Jade ros_core is extended to include geneus. In ROS Kinetic ros_core is extended to include gennodejs.
- ros_core: packages: [catkin, cmake_modules, common_msgs, gencpp, geneus(Jade and newer), genlisp, genmsg, gennodejs(Kinetic and newer), genpy, message_generation, message_runtime, ros, ros_comm, rosbag_migration_rule, rosconsole_bridge, roscpp_core, rosgraph_msgs, roslisp, rospack, std_msgs, std_srvs]
The ros_base metapackage composes the ros_core metapackage with commonly used libraries. It may not contain any GUI dependencies.
- ros_base: extends: [ros_core] packages: [actionlib, bond_core, class_loader, dynamic_reconfigure, nodelet_core, pluginlib]
The robot metapackage is defined to be core, stable, ROS libraries for any robot hardware. It is the "general robotics" libraries of ROS. It may not contain any GUI dependencies.
- robot: extends: [ros_base] packages: [control_msgs, diagnostics, executive_smach, filters, geometry, robot_model, robot_state_publisher, xacro]
The capability variants organize commonly used libraries that are specific to a class of use case. We also define a simulators variant that provides an organizational role for higher-level variants. We discourage GUI dependencies in these stacks, if possible.
- perception: extends: [ros_base] packages: [image_common, image_pipeline, image_transport_plugins, laser_pipeline, perception_pcl, vision_opencv] - simulators: extends: [robot] packages: [gazebo_ros_pkgs, rqt_common_plugins, rqt_robot_plugins, stage_ros] - viz: extends: [ros_base] packages: [rqt_common_plugins, rqt_robot_plugins, rviz]
The desktop variants are main entry points for users. The desktop_full is a "batteries included" experience for users and attempts to collect stable, well-documented libraries. These libraries may be specific to certain classes of robots, such as mobile robots, though they are not specific to a particular robot. The desktop variant is more minimal and only provides the stacks in the robot variant, plus visualization and debugging tools. Both of these variants contain tutorials for the stacks they provide. urdf_tutorials are only in desktop_full because they depend on the simulator.
- desktop: extends: [robot, viz] packages: [angles, common_tutorials, geometry_tutorials, ros_tutorials, roslint, visualization_tutorials] - desktop_full: extends: [desktop, perception, simulators] packages: [urdf_tutorial]
Please see REP 108  for discussion of institution-specific metapackages.
When creating robot or institution specific metapackages consider using the *_robot and *_desktop and *_base form where * is the institution or robot name.
An institution is not required to provide a metapackage, they are mainly provided for convenience and identity.
The metapackages in this REP provide the same semantic top level entry points while simplifying the definitions.
|||(1, 2, 3) REP 108: Diamondback Variants (http://www.ros.org/reps/rep-0108.html)|
|||REP 127: Specification of package manifest format (https://ros.org/reps/rep-0127.html)|
|||REP 131: Groovy Variants (http://www.ros.org/reps/rep-0131.html)|
|||ROS Metapackages Repository (https://github.com/ros/metapackages)|
This document has been placed in the public domain.