ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | Q&A
Ask Your Question

How to access the runtime value of a LaunchConfiguration instance within custom launch code (injected via an OpaqueFunction) in ROS2?

asked 2022-03-05 13:50:01 -0600

updated 2022-03-05 15:11:57 -0600

I'm trying to add some dynamic behavior into my python launch file(s) that depends on the runtime value of a/few LaunchConfiguration object(s).

For example, I have a yaml_file_path argument:

def generate_launch_description():
   yaml_file_path = LaunchConfiguration('yaml_file_path')
   yaml_file_path_arg = DeclareLaunchArgument('yaml_file_path')

The yaml file contains a list of entities that I need to generate IncludeLaunchDescription instances for, which will be returned by my generate_launch_description() api. For example:

# Only required for launch processing. These are not node params.
   prefix: <some folder path>
   prefix: <some other folder path>

I understand I need to define and return an OpaqueFunction within my generate_launch_description() method, as below:

def generate_launch_description():
   yaml_file_path = LaunchConfiguration('yaml_file_path')
   yaml_file_path_arg = DeclareLaunchArgument('yaml_file_path')

   variable_includer = OpaqueFunction(generate_variable_include_list, ...<???>...)     # <<<<<<< ??? <<<<<<<<

   return [

The generate_variable_include_list() method injected above generates a module_includes containing the IncludeLaunchDescription instances for each item in yaml file:

def generate_variable_include_list(context: LaunchContext, yaml_file_path: str) -> List[LaunchDescriptionEntity]:
   settings: Dict[str, Any] = parse_yaml_file_to_dict(yaml_file_path)

   module_includes: List[IncludeLaunchDescription] = []
   for (key,value) in settings.items():
               PathJoinSubstitution([settings[key]['prefix'], ""])
         LogInfo(msg=(["\tIncluding file: ", PathJoinSubstitution([settings[key]['prefix'], ""])]))
   return module_includes

... but, I can't seem to find documentation about the following:

  • how to accept the yaml_file_path into this generate_variable_include_list() function above? (Specifically shown with the <???> comment). I mean, what type is the argument supposed to be? That is, should I be passing in the LaunchConfiguration object as-is, i.e, yaml_file_path, or some post-processed version of it?
  • how to use that yaml_file_path value in that function? That is, since it is an asyncio future, how do I access the resolved (runtime) outcome of that LaunchConfiguration instance within my generate_variable_include_list() method? Should I invoke the perform() API on the object, or would that cause redundant evaluation of the associated future? Is there any cache that I can lookup instead, at runtime, for the resolved value of this entity?
  • And, in a general sense, what if the entity in question was any LaunchDescriptionEntity object, not just a LaunchConfiguration, and I wanted to obtain its resolved/future value in my OpaqueFunction above?

Some sample code, wherever applicable, would be greatly appreciated.

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2022-03-10 18:30:00 -0600

updated 2022-03-11 00:55:31 -0600

When using OpaqueFunction you can define the LaunchConfiguration variable inside it and use its .perform(context) method. You can check it out how I did it here So, in short

def launch_setup(context, *args, **kwargs):
    some_var = LaunchConfiguration('some_variable')
    some_var_runtime_value = some_var.perform(context)

I hope this helps

edit flag offensive delete link more


Thanks @Serafadam. The example link you included above takes me to Perhaps you meant to include a github link instead?

alikureishy gravatar image alikureishy  ( 2022-03-10 20:41:05 -0600 )edit

Ah, sorry, it's fixed now

Serafadam gravatar image Serafadam  ( 2022-03-11 00:55:15 -0600 )edit

Thanks @Serafadam! The example link is very helpful.

alikureishy gravatar image alikureishy  ( 2022-03-11 23:50:35 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools



Asked: 2022-03-05 13:50:01 -0600

Seen: 203 times

Last updated: Mar 11