mech_import

Сгенерируйте модель от Физического XML-файла Моделирования

Синтаксис

mech_import mech_import('filename.xml') mech_import('filename.xml', option1, value1, option2, value2, ...)

Описание

Предупреждение

Это содержимое характерно для программного обеспечения Simscape™ Multibody™ First Generation. Функции первого поколения намечают, чтобы быть удержанными от использования и нужно избежать.

mech_import открывает диалоговое окно Import Physical Modeling XML. Смотрите Альтернативы.

mech_import('filename.xml') генерирует модель Simscape Multibody от Физического XML-файла Моделирования под названием filename.xml. Для XML-файла, сгенерированного от автоматизированного проектирования (CAD), имя сгенерированной модели совпадает с исходным блоком CAD, независимо от имени XML-файла.

mech_import('filename.xml', option1, value1, option2, value2, ...) генерирует модель Simscape Multibody от filename.xml, с помощью заданных пар значения опции при импорте.

Функция mech_import или генерирует новую модель Simscape Multibody или обновляет ранее сгенерированную модель Simscape Multibody, которую вы задаете. Это также генерирует или обновляет связанные файлы геометрии тела.

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

mech_import требует входа того и принимает дополнительные дополнительные входные параметры.

`'filename.xml'`	Введите имя XML-файла. Замените `filename` на имя XML-файла, который вы хотите импортировать. Расширение `.xml` в этом входе является дополнительным. Этот вход требуется. Значение по умолчанию: `''`
`'ImportMode'`	`0` – Импортируйте XML в новую модель. `1` – Используйте XML, чтобы обновить содержимое модели или подсистемы. `2` – Добавьте содержимое нового XML к модели или подсистеме. `3` – Импортируйте содержимое нового XML в модель или подсистему и удалите существующее содержимое. Этот вход является дополнительным. Значение по умолчанию: `0`
`'ModelToImportInto'`	Строка, задающая целевую модель для импорта или обновления существующих блоков. Этот вход является дополнительным. Значение по умолчанию: Исходное имя сборки CAD
`'SubsystemToImportInto'`	Строка, задающая целевую подсистему для импорта или обновления существующих блоков. Этот вход является дополнительным. Значение по умолчанию: Исходное имя компонента CAD
`'CreateTopSS'`	`true` или `false` – Создать ли новую подсистему, если заданная подсистема (`'SubsystemToImportInto'`) не существует в целевой модели. Применяется когда `'ImportMode'` = 2. Этот вход является дополнительным. По умолчанию: false
`'ModelSimplificationOpt'`	`0` – Следуйте за импортированной иерархией и не сделайте упрощения в сгенерированной иерархии подсистемы. `1` – Принесите все соединения топ-модели или подсистеме. Группа и место сварили тела в недавно созданные твердые подсистемы на каждом уровне иерархии модели. `2` – Группа и место сварили тела на каждом уровне иерархии модели в недавно созданные твердые подсистемы на том же уровне. Этот вход является дополнительным. Значение по умолчанию: 0
`'UseDefaultJointNames'`	`'on'` – Используйте объединенные имена по умолчанию, такие как Revolute1, Revolute2, и т.д., и проигнорируйте объединенные имена, заданные в XML-файле. `'off'` Используйте объединенные имена от XML-файла. Этот вход является дополнительным. Значение по умолчанию: `'on'`
`'UseBlockNamesForSpacing'`	`'on'` – Пробел блокируется так, чтобы их имена не накладывались. `'off'` Используйте только размер блока, чтобы расположить блоки с интервалами. Этот вход является дополнительным. Значение по умолчанию: `'off'`
`'LayoutDirection'`	`'LR'` – Схема растет слева направо. `'TB'` – Схема растет сверху донизу. Этот вход является дополнительным. Значение по умолчанию: `'LR'`
`'LayoutWithUpdate'`	`true` или `false` – Расположить ли все импортированные блоки после обновления их параметров. Применяется только при обновлении. Если ложь, расположение недавно импортировало блоки отдельно от существующих блоков. Этот вход является дополнительным. По умолчанию: false
`'EnableIndvlBlkUpdCtrl'`	`true` или `false` – Уважать ли настройки обновления отдельных блоков. Если ложь, обновление все блоки независимо. Этот вход является дополнительным. Значение по умолчанию: `true`
`'NewJointsAtTopLevel'`	`true` или `false` – Добавить ли новые соединения в обновленной модели на высшем уровне иерархии модели, заданной или `ModelToImportInto` или опцией `SubsystemToImportInto`. Применяется когда `'ImportMode'` = 1. Этот вход является дополнительным. По умолчанию: false
`'BackupMode'`	`0` – Не создавайте резервную версию модели при обновлении существующей модели. `1` – Создайте резервную версию модели в той же папке как обновленная модель. `2` – Задайте имя для резервной версии модели и местоположения. Этот вход является дополнительным. Значение по умолчанию: 1
`'BackupLocation'`	Задайте полный путь, где средство импорта создаст резервную версию модели. Применяется когда `'BackupMode'` = 2. Этот вход является дополнительным. Значение по умолчанию: `''`

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

mech_import производит или обновляет один образцовый файл.

Выходное имя модели по умолчанию совпадает с именем сборки, заданным в Физическом XML-файле Моделирования. Выходное имя модели независимо от имени XML-файла, используемого в качестве входа.

Примеры

Импорт новой модели

Создайте Физический XML-файл Моделирования для гипотетического блока CAD под названием assembly:

С вашей платформы CAD экспортируйте блок. Вызовите файл assembly.xml.
Поместите или скопируйте XML-файл в свой текущий MATLAB^® рабочая папка.
В командной строке войти
```
mech_import('assembly.xml')
```
Программное обеспечение Simscape Multibody генерирует блок-схему в образцовом файле под названием assembly.mdl. Можно сохранить, переименовать, изменить и запустить эту модель.

Импорт новой модели с именем не по умолчанию

Поменяйте имя модели от значения по умолчанию:

Когда вы вызовете функцию, чтобы импортировать XML-файл, используйте опцию 'ModelToImportInto'.
Когда вы будете использовать диалоговое окно, чтобы импортировать XML-файл, используйте поле Specify model to import into.
После того, как вы импортируете XML-файл и сгенерируете модель, когда вы сохраняете модель.

Примените имя не по умолчанию к финалу сгенерированная модель таким образом:

mech_import('robot.xml','ImportMode',0, ...
           'ModelToImportInto','myrobot')

Эта форма функции импортирует файл в качестве примера, robot.xml, в новую модель Simscape Multibody, названную myrobot.

Импорт новой модели, в то время как упрощение иерархии модели

В командной строке войти

showdemo mech_modelsimplification

отобразить страницу в качестве примера и учиться собирающийся упростить соединения и сваренные тела в сгенерированной модели.

Обновление существующей модели с несколькими опциями

Обновите существующую модель (existingModel) с XML-файлом existingModelUpdate.xml:

mech_import('existingModelUpdate.xml','ImportMode',1, ...
            'ModelToImportInto','existingModel', ...
            'LayoutWithUpdate',true,'EnableIndvlBlkUpdCtrl',true, ...
            'BackupMode',2,'BackupLocation','C:\backupdir\')

Средство импорта располагает обновленные блоки, в то время как уважение отдельного блока обновляет настройки. Функция также создает резервную версию модели и задает местоположение резервирных копий не по умолчанию (C:\backupdir\).

Альтернативы

Если вы вводите mech_import в командной строке без входных параметров, диалоговое окно Import Physical Modeling XML открывается.

Используйте контекстно-зависимую справку в этом диалоговом окне для получения информации о его параметрах. Эти параметры обеспечивают то же управление генерацией моделей Simscape Multibody от Физических XML-файлов Моделирования также, как и входные параметры функции.

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