You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Fix some issues related with composition in the ros2_overview tutorial.
Signed-off-by: Carlos Agüero <[email protected]>
Co-authored-by: Addisu Z. Taddese <[email protected]>
Copy file name to clipboardExpand all lines: harmonic/ros2_overview.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ ROS container. When this happens, all the nodes within the same ROS container
39
39
share the same process and can leverage intraprocess communication.
40
40
41
41
The parameter `create_own_container` only makes sense when `use_composition` is
42
-
set to `True`. This parameter lets you control whether your start a ROS
42
+
set to `True`. This parameter lets you control whether you start a ROS
43
43
container for your composable nodes or you defer to an external ROS container.
44
44
45
45
Our recommendation is to always set the `use_composition` parameter to `True`
@@ -57,12 +57,16 @@ ROS nodes will be intraprocess.
57
57
58
58
This figure illustrates the concept of composition. The left diagram captures
59
59
the idea of not using composition. All the three example nodes are standalone
60
-
nodes, and they can talk via interprocess communication. The center diagram
61
-
represents the scenario where we use composition and we start our own container
62
-
from our own launch file. All communication is intraprocess here. The right
63
-
diagram is still using composition but the launch file doesn't start the
64
-
container directly. This setup by itself will not work until you start an
65
-
external ROS container (manually or via a separate launch file).
60
+
nodes, and they can talk via interprocess communication using the bridge.
61
+
The center diagram represents the scenario where we can use composition with a ROS container created by a `ros_gz` launch file containing both Gazebo and the bridge, and an additional
62
+
consumer node outside that we cannot control. All communication between Gazebo
63
+
and the bridge is intraprocess and interprocess between the external consumer
64
+
node and the bridge.
65
+
The diagram on the right side is using composition across all nodes but the
66
+
`ros_gz` launch file doesn't start its own container directly. This setup by itself will
67
+
not work until you start an external ROS container (manually or via a separate launch file). In this diagram, the external ROS consumer node starts the
68
+
container. We're using the Nav2 logo as an example of external ROS 2 consumer
69
+
node.
66
70
67
71
You can learn more about ROS composition in [this tutorial](https://docs.ros.org/en/jazzy/Tutorials/Intermediate/Composition.html).
0 commit comments