rosparam

Доступ к значениям сервера параметра ROS

свернуть все на странице

Синтаксис

list = rosparam("list")

list = rosparam("list",namespace)

pvalOut = rosparam("get",pname)

pvalOut = rosparam("get",namespace)

rosparam("set",pname,pval)

rosparam("delete",pname)

rosparam("delete",namespace)

ptree = rosparam

Описание

list = rosparam("list") возвращает список всех названий параметра ROS от ведущего устройства ROS.

Упрощенная форма: rosparam list

list = rosparam("list",namespace) возвращает список всех названий параметра под заданным пространством имен ROS.

Упрощенная форма: rosparam list namespace

пример

pvalOut = rosparam("get",pname) получает значение заданного параметра.

Упрощенная форма: rosparam get pname

pvalOut = rosparam("get",namespace) получает значения всех параметров под заданным пространством имен как структура.

Упрощенная форма: rosparam get namespace

rosparam("set",pname,pval) устанавливает значение для заданного названия параметра. Если название параметра не существует, функция добавляет новый параметр в дереве параметра.

Упрощенная форма: rosparam set pname pval

Смотрите Ограничения для ограничений на pval.

rosparam("delete",pname) удаляет параметр из дерева параметра. Если параметр не существует, функция отображает ошибку.

Упрощенная форма: rosparam delete pname

rosparam("delete",namespace) удаляет все параметры под данным пространством имен от дерева параметра.

Упрощенная форма: rosparam delete namespace

пример

ptree = rosparam создает объект дерева параметра, ptree. После ptree создается, связь с сервером параметра остается персистентной, пока объект не удален, или ведущее устройство ROS становится недоступным.

Дерево параметра ROS связывается с сервером параметра ROS. Сервер параметра ROS может сохранить строки, целые числа, удваивается, булевские переменные и массивы ячеек. Параметры доступны каждым узлом в сети ROS. Используйте параметры, чтобы хранить статические данные, такие как параметры конфигурации. Используйте getНабор, has, search, и del функции, чтобы управлять и просмотреть значения параметров.

Следующие типы данных ROS поддерживаются как значения параметров. Для каждого типа данных ROS также перечислен соответствующий тип данных MATLAB^®.

32-битное целое число — int32
Булевская переменная — logical
дважды — double
строка — вектор символов (char)
список — массив ячеек (cell)
словарь — структура (struct)

Примеры

свернуть все

Доберитесь и значения параметров набора

Этот пример использует:

ROS Toolbox

Скрипт Open Live Script

Соединитесь с сетью ROS, чтобы установить и получить значения параметров ROS на дереве параметра ROS. Можно получить списки параметров в их данных пространствах имен также. Этот пример использует упрощенную форму, которая подражает интерфейсу командной строки ROS.

Соединитесь с сетью ROS.

rosinit

Initializing ROS master on http://bat6306glnxa64:33679/.
Initializing global node /matlab_global_node_99968 with NodeURI http://bat6306glnxa64:34453/

Установите значения параметров.

rosparam set /string_param 'param_value'
rosparam set /double_param 1.2

Чтобы установить параметр списка, используйте функциональную форму.

rosparam('set', '/list_param', {int32(5), 124.1, -20, 'some_string'});

Получите список параметров с помощью формы командной строки.

rosparam list

/double_param
/list_param  
/string_param

Перечислите параметры в определенном пространстве имен.

rosparam list /double

/double_param

Получите значение параметра.

rosparam get /list_param

{5, 124.1, -20, some_string}

Удалите параметр. Перечислите параметры, чтобы проверить, что это было удалено.

rosparam delete /double_param
rosparam list

/list_param  
/string_param

Закройте сеть ROS.

rosshutdown

Shutting down global node /matlab_global_node_99968 with NodeURI http://bat6306glnxa64:34453/
Shutting down ROS master on http://bat6306glnxa64:33679/.

Создайте объект дерева параметра и просмотрите параметры

Этот пример использует:

ROS Toolbox

Скрипт Open Live Script

Соединитесь с сетью ROS. Параметры ROS должны уже быть доступными на ведущем устройстве ROS.

rosinit('192.168.17.128')

Initializing global node /matlab_global_node_91663 with NodeURI http://192.168.17.1:52951/

Создайте ParameterTree объект с помощью rosparam.

ptree = rosparam;

Перечислите доступные параметры на ведущем устройстве ROS.

ptree.AvailableParameters

ans = 33×1 cell array
    {'/bumper2pointcloud/pointcloud_radius'         }
    {'/camera/imager_rate'                          }
    {'/camera/rgb/image_raw/compressed/format'      }
    {'/camera/rgb/image_raw/compressed/jpeg_quality'}
    {'/camera/rgb/image_raw/compressed/png_level'   }
    {'/cmd_vel_mux/yaml_cfg_file'                   }
    {'/depthimage_to_laserscan/output_frame_id'     }
    {'/depthimage_to_laserscan/range_max'           }
    {'/depthimage_to_laserscan/range_min'           }
    {'/depthimage_to_laserscan/scan_height'         }
    {'/depthimage_to_laserscan/scan_time'           }
    {'/gazebo/auto_disable_bodies'                  }
    {'/gazebo/cfm'                                  }
    {'/gazebo/contact_max_correcting_vel'           }
    {'/gazebo/contact_surface_layer'                }
    {'/gazebo/erp'                                  }
    {'/gazebo/gravity_x'                            }
    {'/gazebo/gravity_y'                            }
    {'/gazebo/gravity_z'                            }
    {'/gazebo/max_contacts'                         }
    {'/gazebo/max_update_rate'                      }
    {'/gazebo/sor_pgs_iters'                        }
    {'/gazebo/sor_pgs_precon_iters'                 }
    {'/gazebo/sor_pgs_rms_error_tol'                }
    {'/gazebo/sor_pgs_w'                            }
    {'/gazebo/time_step'                            }
    {'/robot_description'                           }
    {'/robot_state_publisher/publish_frequency'     }
    {'/rosdistro'                                   }
    {'/roslaunch/uris/host_192_168_17_128__34863'   }
    {'/rosversion'                                  }
    {'/run_id'                                      }
    {'/use_sim_time'                                }

Закройте сеть ROS.

rosshutdown

Shutting down global node /matlab_global_node_91663 with NodeURI http://192.168.17.1:52951/

Установите словарь значений параметров

Этот пример использует:

ROS Toolbox

Скрипт Open Live Script

Используйте структуры, чтобы задать словарь параметров ROS под определенным пространством имен.

Соединитесь с сетью ROS.

rosinit

Initializing ROS master on http://bat6306glnxa64:36809/.
Initializing global node /matlab_global_node_61873 with NodeURI http://bat6306glnxa64:45753/

Создайте словарь значений параметров. Этот словарь содержит информацию, относящуюся к изображению. Отобразите структуру, чтобы проверить значения.

image = imread('peppers.png');

pval.ImageWidth = size(image,1);
pval.ImageHeight = size(image,2);
pval.ImageTitle = 'peppers.png';
disp(pval)

     ImageWidth: 384
    ImageHeight: 512
     ImageTitle: 'peppers.png'

Установите словарь значений с помощью желаемого пространства имен.

rosparam('set','ImageParam',pval)

Получите параметры с помощью пространства имен. Проверьте значения.

pval2 = rosparam('get','ImageParam')

pval2 = struct with fields:
    ImageHeight: 512
     ImageTitle: 'peppers.png'
     ImageWidth: 384

Закройте сеть ROS.

rosshutdown

Shutting down global node /matlab_global_node_61873 with NodeURI http://bat6306glnxa64:45753/
Shutting down ROS master on http://bat6306glnxa64:36809/.

Входные параметры

свернуть все

`namespace` — Пространство имен параметра ROS
представьте скаляр в виде строки | вектор символов

Пространство имен параметра ROS, заданное как скаляр строки или вектор символов. Все названия параметра начиная с этой строки перечислены при вызове rosparam("list",namespace).

`pname` — Название параметра ROS
представьте скаляр в виде строки | вектор символов

Название параметра ROS, заданное как скаляр строки или вектор символов.

`pval` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | представьте скаляр в виде строки | вектор символов | массив ячеек | структура

Значение параметров ROS или словарь значений, заданных как поддерживаемый тип данных.

Следующие типы данных ROS поддерживаются как значения параметров. Для каждого типа данных ROS также перечислен соответствующий тип данных MATLAB:

32-битные целые числа — int32
Булевские переменные — logical
удваивается — double
строки — представляют в виде строки скаляр, string, или вектор символов, char
списки — массив ячеек
словари — структура

Выходные аргументы

свернуть все

`list` — Список параметров
массив ячеек из символьных векторов

Список параметров, возвращенный как массив ячеек из символьных векторов. Это - список всех параметров, доступных на ведущем устройстве ROS.

`ptree` — Дерево параметра
`ParameterTree` указатель на объект

Дерево параметра, возвращенное как ParameterTree указатель на объект. Используйте этот объект для получения информации о параметре ссылки, например, ptree.AvailableFrames.

`pvalOut` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | вектор символов | массив ячеек | структура

Значение параметров ROS, заданное как поддерживаемый тип данных MATLAB. При определении namespace входной параметр, pvalOut возвращен как структура значения параметров под данным пространством имен.

Следующие типы данных ROS поддерживаются как значения параметров. Для каждого типа данных ROS также перечислен соответствующий тип данных MATLAB.

Тип данных ROS	Тип данных MATLAB
32-битное целое число	`int32`
Булевская переменная	`logical`
'double'	`double`
строка	вектор символов (`char`)
список	массив ячеек (`cell`)
словарь	структура (`struct`)

Ограничения

Неподдерживаемые Типы данных: Base64-закодированные двоичные данные и iso8601 данные из ROS не поддержаны.
Упрощенные Команды: При использовании упрощенной команды rosparam set pname pval, значение параметров интерпретировано как:
- logical — Если pval "true" или "false"
- int32 — Если pval целое число, например, 5
- double — Если pval дробный номер, например, 1.256
- вектор символов — Если pval любое другое значение

Документация

rosparam

Синтаксис

Описание

Примеры

Доберитесь и значения параметров набора

Создайте объект дерева параметра и просмотрите параметры

Установите словарь значений параметров

Входные параметры

`namespace` — Пространство имен параметра ROS
представьте скаляр в виде строки | вектор символов

`pname` — Название параметра ROS
представьте скаляр в виде строки | вектор символов

`pval` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | представьте скаляр в виде строки | вектор символов | массив ячеек | структура

Выходные аргументы

`list` — Список параметров
массив ячеек из символьных векторов

`ptree` — Дерево параметра
`ParameterTree` указатель на объект

`pvalOut` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | вектор символов | массив ячеек | структура

Ограничения

Смотрите также

Функции

Объекты

Введенный в R2019b

Документация ROS Toolbox

Поддержка

Документация

rosparam

Синтаксис

Описание

Примеры

Доберитесь и значения параметров набора

Создайте объект дерева параметра и просмотрите параметры

Установите словарь значений параметров

Входные параметры

namespace — Пространство имен параметра ROS представьте скаляр в виде строки | вектор символов

pname — Название параметра ROS представьте скаляр в виде строки | вектор символов

pval — Значение параметров ROS или словарь значений int32 | logical | double | представьте скаляр в виде строки | вектор символов | массив ячеек | структура

Выходные аргументы

list — Список параметров массив ячеек из символьных векторов

ptree — Дерево параметра ParameterTree указатель на объект

pvalOut — Значение параметров ROS или словарь значений int32 | logical | double | вектор символов | массив ячеек | структура

Ограничения

Смотрите также

Функции

Объекты

Введенный в R2019b

Документация ROS Toolbox

Поддержка

`namespace` — Пространство имен параметра ROS
представьте скаляр в виде строки | вектор символов

`pname` — Название параметра ROS
представьте скаляр в виде строки | вектор символов

`pval` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | представьте скаляр в виде строки | вектор символов | массив ячеек | структура

`list` — Список параметров
массив ячеек из символьных векторов

`ptree` — Дерево параметра
`ParameterTree` указатель на объект

`pvalOut` — Значение параметров ROS или словарь значений
`int32` | `logical` | `double` | вектор символов | массив ячеек | структура