ROS parameter server - Step-by-Step Execution

Concept Flow - ROS parameter server

Start Node

↓

Check Parameter Server

↓

Get Parameter?

Yes→Retrieve Value

↓

Use Default

↓

Set Parameter

↓

Node Uses Parameter

↓

Node Runs with Configured Parameters

The node starts, checks the parameter server for parameters, retrieves or sets them, then uses these parameters during execution.

Execution Sample

ROS

import rospy
rospy.init_node('example_node')
param = rospy.get_param('~speed', 1.0)
rospy.set_param('max_speed', 5.0)
print(param)

This code initializes a ROS node, gets a parameter 'speed' with default 1.0, sets 'max_speed' to 5.0, and prints the speed.

Execution Table

Step	Action	Parameter Accessed	Value Before	Value After	Output
1	Initialize node	-	-	-	-
2	Get parameter '~speed'	~speed	Not set	1.0	Returns default 1.0
3	Set parameter 'max_speed'	max_speed	Not set	5.0	-
4	Print parameter 'speed'	-	-	-	1.0

💡 All parameters accessed or set; node uses parameters for operation.

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
param	undefined	1.0	1.0	1.0
max_speed	undefined	undefined	5.0	5.0

Key Moments - 2 Insights

Why does get_param return 1.0 even though 'speed' was never set?

Because in step 2 of the execution_table, get_param uses the default value 1.0 when 'speed' is not found on the parameter server.

What happens if you try to get a parameter without a default and it does not exist?

The node will raise an error or exception because the parameter is missing, unlike in step 2 where a default was provided.

Visual Quiz - 3 Questions

Look at the execution table, what is the value of 'param' after step 2?

A undefined

B 5.0

C 1.0

D 0.0

💡 Hint

Check the 'Value After' column for step 2 in the execution_table.

At which step is 'max_speed' set on the parameter server?

A Step 3

B Step 2

C Step 1

D Step 4

💡 Hint

Look for 'Set parameter' action in the execution_table.

If you remove the default value in get_param for 'speed', what will happen at step 2?

A Returns 0

B Raises an error

C Returns None

D Returns 1.0

💡 Hint

Refer to key_moments about missing parameters without defaults.

Concept Snapshot

ROS Parameter Server Quick Guide:
- Nodes use parameter server to store config data.
- Use rospy.get_param('param_name', default) to read parameters.
- Use rospy.set_param('param_name', value) to write parameters.
- If parameter missing and no default, get_param raises error.
- Parameters help nodes share config without code changes.

Full Transcript

This visual execution trace shows how a ROS node interacts with the parameter server. First, the node initializes. Then it tries to get a parameter named 'speed' with a default value of 1.0. Since 'speed' is not set, the default is returned. Next, the node sets a new parameter 'max_speed' to 5.0 on the server. Finally, it prints the retrieved 'speed' value. The variable tracker shows 'param' holds 1.0 after retrieval and 'max_speed' is set to 5.0. Key moments clarify why defaults matter and what happens if parameters are missing without defaults. The quiz tests understanding of parameter values at each step and error handling. This helps beginners see how ROS nodes use the parameter server to configure behavior dynamically.

Practice

1. What is the main purpose of the ROS parameter server?

easy

A. To compile ROS packages

B. To store and share configuration settings between ROS nodes

C. To execute robot movement commands

D. To visualize sensor data in real-time

Solution

1. Step 1: Understand the role of the parameter server

   The ROS parameter server is designed to hold parameters that nodes can access and share, such as configuration values.

2. Step 2: Compare options with this role

   Options A, B, and D describe other ROS functionalities unrelated to parameter storage.

3. Final Answer:

   To store and share configuration settings between ROS nodes -> Option B

4. Quick Check:

   Parameter server = shared settings [OK]

Hint: Parameter server holds shared settings, not commands or data [OK]

Common Mistakes:

• Confusing parameter server with command execution
• Thinking it compiles code
• Mixing it up with visualization tools

2. Which of the following is the correct command to set a parameter named robot_speed to 1.5 using rosparam?

easy

A. rosparam set robot_speed 1.5

B. rosparam get robot_speed 1.5

C. rosparam delete robot_speed 1.5

D. rosparam list robot_speed 1.5

Solution

1. Step 1: Identify the command to set a parameter

   The rosparam set command is used to assign a value to a parameter on the parameter server.

2. Step 2: Verify the syntax

   The syntax is rosparam set <param_name> <value>, so rosparam set robot_speed 1.5 is correct.

3. Final Answer:

   rosparam set robot_speed 1.5 -> Option A

4. Quick Check:

   Set parameter = rosparam set [OK]

Hint: Use 'rosparam set' to assign values to parameters [OK]

Common Mistakes:

• Using 'get' instead of 'set' to assign values
• Trying to delete or list with value arguments
• Incorrect command syntax

3. Given the following Python ROS node code snippet, what will be printed if the parameter max_speed is not set on the parameter server?

import rospy
rospy.init_node('speed_node')
max_speed = rospy.get_param('max_speed', 2.0)
print(max_speed)

medium

A. It will print 0

B. It will print None

C. It will print 2.0

D. It will raise a KeyError

Solution

1. Step 1: Understand the use of rospy.get_param with default

   The function rospy.get_param('max_speed', 2.0) tries to get the parameter 'max_speed'. If it does not exist, it returns the default value 2.0.

2. Step 2: Apply this to the scenario

   Since 'max_speed' is not set, the default 2.0 will be assigned and printed.

3. Final Answer:

   It will print 2.0 -> Option C

4. Quick Check:

   Missing param returns default = 2.0 [OK]

Hint: get_param returns default if param missing [OK]

Common Mistakes:

• Expecting an error if parameter missing
• Assuming None is returned by default
• Confusing default value usage

4. You wrote this code to get a parameter but it crashes with a KeyError. What is the problem?

import rospy
rospy.init_node('node')
value = rospy.get_param('unknown_param')
print(value)

medium

A. The parameter 'unknown_param' does not exist and no default was provided

B. The node was not initialized before getting the parameter

C. The print statement is incorrect syntax

D. The parameter server is not running

Solution

1. Step 1: Analyze the get_param call without default

   Calling rospy.get_param('unknown_param') without a default raises a KeyError if the parameter does not exist.

2. Step 2: Confirm the cause of the crash

   Since 'unknown_param' is missing and no default is given, the code crashes with KeyError.

3. Final Answer:

   The parameter 'unknown_param' does not exist and no default was provided -> Option A

4. Quick Check:

   Missing param + no default = KeyError [OK]

Hint: Always provide default or check param exists to avoid KeyError [OK]

Common Mistakes:

• Assuming node init causes KeyError
• Thinking print syntax is wrong
• Ignoring parameter server status

5. You want to set multiple parameters at once for a robot configuration using a YAML file named config.yaml. Which command correctly loads all parameters from this file onto the ROS parameter server under the namespace /robot?

hard

A. rosparam set config.yaml /robot

B. rosparam delete config.yaml /robot

C. rosparam get config.yaml /robot

D. rosparam load config.yaml /robot

Solution

1. Step 1: Identify the command to load parameters from a file

   The rosparam load command loads parameters from a YAML file onto the parameter server.

2. Step 2: Confirm the correct syntax for namespace

   Using rosparam load config.yaml /robot loads all parameters under the /robot namespace.

3. Final Answer:

   rosparam load config.yaml /robot -> Option D

4. Quick Check:

   Load YAML file with rosparam load [OK]

Hint: Use 'rosparam load' to import YAML parameters [OK]

Common Mistakes:

• Using 'set' instead of 'load' for files
• Trying to 'get' or 'delete' files
• Omitting namespace or using wrong syntax