Conditional launching in ROS

Introduction

Conditional launching lets you start parts of your robot system only when certain conditions are true. This saves resources and makes your robot smarter.

Start a sensor node only if the sensor is connected.

Launch a camera driver only if the camera is enabled in settings.

Run a navigation module only if the robot is in autonomous mode.

Activate debugging tools only when debugging is turned on.

Syntax

ROS

launch_ros.actions.Node(
    package='my_package',
    executable='my_node',
    condition=IfCondition(LaunchConfiguration('my_condition'))
)

Use IfCondition to check if a launch argument or configuration is true.

Conditions control whether a node or action runs during launch.

Examples

This example launches sensor_node only if the use_sensor argument is set to true.

ROS

from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument
from launch.conditions import IfCondition
from launch_ros.actions import Node

def generate_launch_description():
    return LaunchDescription([
        DeclareLaunchArgument('use_sensor', default_value='false'),
        Node(
            package='sensor_package',
            executable='sensor_node',
            condition=IfCondition(LaunchConfiguration('use_sensor'))
        )
    ])

Launches the camera node only if enable_camera is true.

ROS

Node(
    package='camera_package',
    executable='camera_node',
    condition=IfCondition(LaunchConfiguration('enable_camera'))
)

Sample Program

This launch file declares an argument start_navigation. The navigation_node runs only if start_navigation is set to true when launching.

ROS

from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument
from launch.conditions import IfCondition
from launch.substitutions import LaunchConfiguration
from launch_ros.actions import Node

def generate_launch_description():
    return LaunchDescription([
        DeclareLaunchArgument('start_navigation', default_value='false', description='Start navigation node'),
        Node(
            package='nav_package',
            executable='navigation_node',
            condition=IfCondition(LaunchConfiguration('start_navigation'))
        )
    ])

Important Notes

Always declare launch arguments before using them in conditions.

Conditions help keep your launch files flexible and efficient.

Summary

Conditional launching controls which nodes start based on settings.

Use IfCondition with launch arguments to enable or disable nodes.

This helps save resources and customize robot behavior easily.

Practice

1. What is the main purpose of using conditional launching in ROS launch files?

easy

A. To update ROS to the latest version

B. To speed up the robot's movement

C. To change the robot's hardware automatically

D. To start nodes only when certain conditions are met

Solution

1. Step 1: Understand conditional launching concept

   Conditional launching allows starting nodes only if specific conditions are true, saving resources.

2. Step 2: Identify the main purpose

   The main goal is to control which nodes run based on conditions, not to affect hardware or speed directly.

3. Final Answer:

   To start nodes only when certain conditions are met -> Option D

4. Quick Check:

   Conditional launching = start nodes conditionally [OK]

Hint: Think: conditional launching controls node start based on conditions [OK]

Common Mistakes:

• Confusing conditional launching with robot speed control
• Thinking it updates hardware automatically
• Assuming it updates ROS version

2. Which syntax correctly uses IfCondition in a ROS 2 Python launch file to conditionally start a node?

easy

A. Node(if='launch_arg == true', package='pkg', executable='node')

B. Node(condition=IfCondition(launch_arg == true), package='pkg', executable='node')

C. Node(condition=IfCondition('launch_arg == "true"'), package='pkg', executable='node')

D. Node(condition=IfCondition('launch_arg = true'), package='pkg', executable='node')

Solution

1. Step 1: Recall correct IfCondition usage

   IfCondition expects a string expression comparing launch arguments, e.g., 'launch_arg == "true"'.

2. Step 2: Check each option's syntax

   Node(condition=IfCondition('launch_arg == "true"'), package='pkg', executable='node') uses correct string comparison and quotes. Others have syntax errors or wrong operators.

3. Final Answer:

   Node(condition=IfCondition('launch_arg == "true"'), package='pkg', executable='node') -> Option C

4. Quick Check:

   IfCondition needs string expression with == [OK]

Hint: Use quotes around condition string and double equals for comparison [OK]

Common Mistakes:

• Using single equals (=) instead of double equals (==)
• Not quoting the condition expression
• Passing boolean directly instead of string

3. Given this launch snippet, what nodes will start if the launch argument use_camera is set to false?

from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument
from launch.conditions import IfCondition
from launch_ros.actions import Node

def generate_launch_description():
    return LaunchDescription([
        DeclareLaunchArgument('use_camera', default_value='false'),
        Node(
            package='camera_pkg',
            executable='camera_node',
            condition=IfCondition('use_camera == "true"')
        ),
        Node(
            package='lidar_pkg',
            executable='lidar_node'
        )
    ])

medium

A. Only lidar_node starts

B. Both camera_node and lidar_node start

C. Only camera_node starts

D. No nodes start

Solution

1. Step 1: Analyze the condition for camera_node

   camera_node starts only if 'use_camera' equals 'true'. Here, 'use_camera' is 'false', so it won't start.

2. Step 2: Check lidar_node launch condition

   lidar_node has no condition, so it always starts.

3. Final Answer:

   Only lidar_node starts -> Option A

4. Quick Check:

   Condition false skips camera_node, lidar_node always runs [OK]

Hint: Nodes without conditions always start; check condition expressions carefully [OK]

Common Mistakes:

• Assuming camera_node starts when use_camera is false
• Thinking no nodes start if condition fails
• Ignoring unconditional nodes

4. Identify the error in this ROS 2 launch file snippet that prevents conditional launching from working:

Node(
    package='my_pkg',
    executable='my_node',
    condition=IfCondition(use_sensor == 'true')
)

medium

A. IfCondition cannot be used with Node

B. use_sensor should be a string inside quotes

C. Missing package name

D. Executable name must be capitalized

Solution

1. Step 1: Check IfCondition argument type

   IfCondition expects a string expression, but here use_sensor is used as a variable without quotes.

2. Step 2: Confirm correct syntax

   The condition should be written as IfCondition('use_sensor == "true"') with quotes around the expression.

3. Final Answer:

   use_sensor should be a string inside quotes -> Option B

4. Quick Check:

   IfCondition needs string condition expression [OK]

Hint: Always quote condition expressions in IfCondition [OK]

Common Mistakes:

• Passing variable without quotes to IfCondition
• Thinking IfCondition is invalid with Node
• Ignoring case sensitivity in executable

5. You want to launch either sim_node or real_node based on a launch argument use_sim. Which launch snippet correctly implements this conditional launching in ROS 2 Python launch file?

hard

A. Node(package='robot_pkg', executable='sim_node', condition=IfCondition('use_sim == "true"'))
Node(package='robot_pkg', executable='real_node', condition=IfCondition('use_sim == "false"'))

B. Node(package='robot_pkg', executable='sim_node', condition=IfCondition(use_sim == true))
Node(package='robot_pkg', executable='real_node', condition=IfCondition(use_sim == false))

C. Node(package='robot_pkg', executable='sim_node')
Node(package='robot_pkg', executable='real_node')

D. Node(package='robot_pkg', executable='sim_node', condition=IfCondition('use_sim = true'))
Node(package='robot_pkg', executable='real_node', condition=IfCondition('use_sim = false'))

Solution

1. Step 1: Check condition syntax for sim_node

   Node(package='robot_pkg', executable='sim_node', condition=IfCondition('use_sim == "true"')) Node(package='robot_pkg', executable='real_node', condition=IfCondition('use_sim == "false"')) uses correct string expressions with double equals and quotes for 'use_sim == "true"'.

2. Step 2: Check condition syntax for real_node

   Node(package='robot_pkg', executable='sim_node', condition=IfCondition('use_sim == "true"')) Node(package='robot_pkg', executable='real_node', condition=IfCondition('use_sim == "false"')) also correctly uses 'use_sim == "false"' for real_node, ensuring only one node launches.

3. Step 3: Verify other options

   Node(package='robot_pkg', executable='sim_node', condition=IfCondition(use_sim == true)) Node(package='robot_pkg', executable='real_node', condition=IfCondition(use_sim == false)) lacks quotes and uses booleans incorrectly; Node(package='robot_pkg', executable='sim_node') Node(package='robot_pkg', executable='real_node') launches both nodes unconditionally; Node(package='robot_pkg', executable='sim_node', condition=IfCondition('use_sim = true')) Node(package='robot_pkg', executable='real_node', condition=IfCondition('use_sim = false')) uses single equals (=) which is invalid.

4. Final Answer:

   Option A correctly uses IfCondition with string expressions and double equals -> Option A

5. Quick Check:

   Use quotes and == for conditions to launch nodes selectively [OK]

Hint: Use '==' inside quotes for conditions; avoid single '=' [OK]

Common Mistakes:

• Using single equals (=) instead of double equals (==)
• Not quoting the condition expression
• Launching both nodes without conditions