sim.utils#

Utility functions for the sim package.

Functions#

load_yaml_to_dict(→ dict)

Load and validate YAML file.

convert_parameter_value(→ Any)

Convert a parameter value to match its type annotation.

build_node_arguments(→ Dict[str, Any])

Build arguments dictionary for node initialization from parameters.

find_package_resource(→ pathlib.Path)

Find a package resource (file or directory), checking source location first (for development),

camel_to_snake(→ str)

get_available_worlds(→ list[str])

Returns a list of the basenames of all of the sdf files in the given path

Module Contents#

load_yaml_to_dict(params_file: pathlib.Path) → dict#

Load and validate YAML file.

convert_parameter_value(param_value: Any, param_annotation: Any, param_name: str) → Any#

Convert a parameter value to match its type annotation.

Parameters:

  • param_value – The parameter value (may be a string from YAML)

  • param_annotation – The type annotation from the function signature

  • param_name – The parameter name (for error messages)

Returns:

The converted parameter value

Raises:

ValueError – If conversion fails

build_node_arguments(node_class: type, params: Dict[str, Any]) → Dict[str, Any]#

Build arguments dictionary for node initialization from parameters.

Parameters:

  • node_class – The node class to instantiate

  • params – Dictionary of parameter values from config

Returns:

Dictionary of arguments ready to pass to node_class.__init__

Raises:

ValueError – If required parameters are missing or invalid

find_package_resource(relative_path: str | pathlib.Path, package_name: str = 'sim', resource_type: str = 'file', logger: Any | None = None, base_file: pathlib.Path | None = None) → pathlib.Path#

Find a package resource (file or directory), checking source location first (for development), then falling back to installed location.

This allows editing resources during development without needing to rebuild.

Parameters:

  • relative_path – Path relative to package root (e.g., ‘simulations/in_house.yaml’ or ‘world_gen/models’)

  • package_name – ROS2 package name (default: ‘sim’)

  • resource_type – ‘file’ or ‘directory’ (default: ‘file’)

  • logger – Optional logger for info messages (if None, no logging)

  • base_file – File to use as reference for source paths (typically Path(__file__) from caller)

Returns:

Path to the resource

Raises:

FileNotFoundError – If resource cannot be found

camel_to_snake(name: str) → str#
get_available_worlds(path: str | pathlib.Path) → list[str]#

Returns a list of the basenames of all of the sdf files in the given path

Parameters:

path – Path to search

Returns:

List of available world names