importrobot
Импортируйте модель дерева твердого тела из файла URDF, текст или модель Simscape Multibody
Синтаксис
Описание
robot = importrobot(filename)rigidBodyTree объект путем парсинга файла Объединенного формата описания робота (URDF) задан filename.
[ импортирует модель Simscape™ Multibody™ и возвращает эквивалентный robot,importInfo] = importrobot(model)rigidBodyTree объект и информация об импорте в importInfo. Только зафиксированные, призматические, и шарнирные соединения поддерживаются в выходе rigidBodyTree объект. Используйте пары "имя-значение" Импорта Модели Simscape Multibody, чтобы импортировать модель, которая использует другие объединенные типы, ограничительные блоки или переменную инерцию.
___ = importrobot(___,Name,Value) предоставляет дополнительные возможности, заданные Name,Value парные аргументы. Используйте любой из предыдущих синтаксисов. Только определенные пары "имя-значение" применяются в зависимости от того, преобразуете ли вы из файла URDF или модели Simscape Multibody.
Примеры
Импортируйте робота из файла URDF
Импортируйте файл URDF как rigidBodyTree объект.
robot = importrobot('iiwa14.urdf')robot =
rigidBodyTree with properties:
NumBodies: 10
Bodies: {1x10 cell}
Base: [1x1 rigidBody]
BodyNames: {1x10 cell}
BaseName: 'world'
Gravity: [0 0 0]
DataFormat: 'struct'
show(robot)
ans =
Axes (Primary) with properties:
XLim: [-1.5000 1.5000]
YLim: [-1.5000 1.5000]
XScale: 'linear'
YScale: 'linear'
GridLineStyle: '-'
Position: [0.1300 0.1100 0.7750 0.8150]
Units: 'normalized'
Show all properties
Импортируйте робота из вектора символов URDF
Задайте вектор символов URDF. Этот вектор символов является минималистским описанием для создания допустимой модели робота.
URDFtext = '<?xml version="1.0" ?><robot name="min"><link name="L0"/></robot>';Импортируйте модель робота. Описание создает rigidBodyTree объект, который имеет только базовую ссылку робота, названную 'L0'.
robot = importrobot(URDFtext)
robot =
rigidBodyTree with properties:
NumBodies: 0
Bodies: {1x0 cell}
Base: [1x1 rigidBody]
BodyNames: {1x0 cell}
BaseName: 'L0'
Gravity: [0 0 0]
DataFormat: 'struct'
Отобразите модель робота с визуальными конфигурациями
Можно импортировать роботов, которые имеют .stl файлы, сопоставленные с файлом Объединенного формата описания робота (URDF), чтобы описать визуальные конфигурации робота. Каждое твердое тело имеет отдельную визуальную заданную геометрию. importrobot функционируйте анализирует файл URDF, чтобы получить робота и визуальные конфигурации модели. Используйте show функция, чтобы визуализировать модель робота в фигуре. Можно затем взаимодействовать с моделью путем нажатия на компоненты, чтобы смотреть их и щелчка правой кнопкой, чтобы переключить видимость.
Импортируйте модель робота как файл URDF. .stl расположение файлов должно быть правильно задано в этом URDF. Добавить другой .stl файлы к отдельным твердым телам, смотрите addVisual.
robot = importrobot('iiwa14.urdf');Визуализируйте робота со связанной визуальной моделью. Кликните по телам или системам координат, чтобы смотреть их. Щелкните правой кнопкой по телам, чтобы переключить видимость для каждой визуальной геометрии.
show(robot);
Импортируйте модель Simscape™ Multibody™ к RigidBodyTree Объект
Импортируйте существующую модель робота Simscape™ Multibody™ в Robotics System Toolbox™ как rigidBodyTree объект.
Откройте модель Simscape™ Multibody™. Это - модель для гуманоидного робота.
open_system('example_smhumanoidrobot.slx')Импортируйте модель.
[robot,importInfo] = importrobot(gcs)
robot =
rigidBodyTree with properties:
NumBodies: 21
Bodies: {1x21 cell}
Base: [1x1 rigidBody]
BodyNames: {1x21 cell}
BaseName: 'Base'
Gravity: [0 0 -9.8066]
DataFormat: 'struct'
importInfo =
rigidBodyTreeImportInfo with properties:
SourceModelName: 'example_smhumanoidrobot'
RigidBodyTree: [1x1 rigidBodyTree]
BlockConversionInfo: [1x1 struct]
Отобразите детали о созданном rigidBodyTree объект.
showdetails(importInfo)
-------------------- Robot: (21 bodies) Idx Body Name Simulink Source Blocks Joint Name Simulink Source Blocks Joint Type Parent Name(Idx) Children Name(s) --- --------- ---------------------- ---------- ---------------------- ---------- ---------------- ---------------- 1 Body01 Info | List | Highlight Joint01 Info | List | Highlight revolute Base(0) Body02(2) 2 Body02 Info | List | Highlight Joint02 Info | List | Highlight revolute Body01(1) Body03(3) 3 Body03 Info | List | Highlight Joint03 Info | List | Highlight revolute Body02(2) Body04(4) 4 Body04 Info | List | Highlight Joint04 Info | List | Highlight revolute Body03(3) 5 Body05 Info | List | Highlight Joint05 Info | List | Highlight revolute Base(0) Body06(6) 6 Body06 Info | List | Highlight Joint06 Info | List | Highlight revolute Body05(5) Body07(7) 7 Body07 Info | List | Highlight Joint07 Info | List | Highlight revolute Body06(6) Body08(8) 8 Body08 Info | List | Highlight Joint08 Info | List | Highlight revolute Body07(7) 9 Body09 Info | List | Highlight Joint09 Info | List | Highlight revolute Base(0) Body10(10) 10 Body10 Info | List | Highlight Joint10 Info | List | Highlight revolute Body09(9) Body11(11) 11 Body11 Info | List | Highlight Joint11 Info | List | Highlight revolute Body10(10) Body12(12) 12 Body12 Info | List | Highlight Joint12 Info | List | Highlight revolute Body11(11) 13 Body13 Info | List | Highlight Joint13 Info | List | Highlight revolute Base(0) Body14(14) 14 Body14 Info | List | Highlight Joint14 Info | List | Highlight revolute Body13(13) Body15(15) 15 Body15 Info | List | Highlight Joint15 Info | List | Highlight revolute Body14(14) Body16(16) 16 Body16 Info | List | Highlight Joint16 Info | List | Highlight revolute Body15(15) 17 Body17 Info | List | Highlight Joint17 Info | List | Highlight revolute Base(0) Body18(18) 18 Body18 Info | List | Highlight Joint18 Info | List | Highlight revolute Body17(17) Body19(19) 19 Body19 Info | List | Highlight Joint19 Info | List | Highlight fixed Body18(18) Body20(20) 20 Body20 Info | List | Highlight Joint20 Info | List | Highlight fixed Body19(19) 21 Body21 Info | List | Highlight Joint21 Info | List | Highlight fixed Base(0) --------------------
Входные параметры
Выходные аргументы
Советы
При импорте модели робота с визуальными сетками, importrobot функционируйте ищет .stl файлы, чтобы присвоить каждому твердому телу, использующему эти правила:
Функция ищет необработанный путь к mesh заданное твердое тело из файла URDF. Ссылки на пакеты ROS имеют
package:\\<pkg_name>удаленный.Абсолютные пути проверяются непосредственно без модификации.
Относительные пути проверяются с помощью следующих директорий в порядке:
Заданный пользователями
MeshPathТекущая папка
Путь MATLAB®
Папка, содержащая файл URDF
Один уровень выше папки, содержащей файл URDF
s
Имя файла от пути к mesh в файле URDF добавлено к
MeshPathвходной параметр.
Если файл mesh все еще не найден, синтаксический анализатор игнорирует файл mesh и возвращает rigidBodyTree объект без визуального.