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:

  1. С вашей платформы CAD экспортируйте блок. Вызовите файл assembly.xml.

  2. Поместите или скопируйте XML-файл в свой текущий MATLAB® рабочая папка.

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

  4. 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-файлов Моделирования также, как и входные параметры функции.

Представленный в R2008b