smexportonshape

Экспортируйте модель блока CAD из программного обеспечения облака Onshape

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

Синтаксис

multibodyDescriptionFile = smexportonshape(assemblyURL)
multibodyDescriptionFile = smexportonshape(assemblyURL,Name,Value)

Описание

multibodyDescriptionFile = smexportonshape(assemblyURL) генерирует файлы, в которых вы нуждаетесь в порядке импортировать модель блока Onshape® в среду Simscape™ Multibody™.

Аргумент assemblyURL является веб-адресом модели блока Onshape, чтобы экспортировать. Чтобы получить веб-адрес, откройте модель Onshape, выберите вкладку блока и скопируйте URL, показанный на вашем веб-браузере.

Сгенерированные файлы включают файл описания мультитела XML и набор файлов ШАГА. XML-файл опознает тела, которые включают модель, и задает их кинематические отношения. Файлы ШАГА обеспечивают 3-D конфигурации тел. По умолчанию все файлы хранятся в текущей папке MATLAB®.

multibodyDescriptionFile вывод является именем файла описания мультитела XML. Необходимо использовать функцию smimport с этим именем в качестве аргумента в порядке импортировать модель Onshape в среду Simscape Multibody. Данные показывают экспорт и этапы импорта рабочего процесса перевода CAD Onshape. Модель Simscape Multibody и файл данных M являются продуктом этапа импорта.

Рабочий процесс перевода Onshape CAD

Вы должны сделать, чтобы активный Onshape считал. В первый раз, когда вы используете эту функцию, необходимо дать права доступа Средства экспорта Simscape Multibody учетной записи Onshape. Функция использует эти привилегии строго, чтобы получить доступ и экспортировать ваши модели Onshape. Программное обеспечение Onshape предоставляет функциональный доступ через лексемы JavaScript, которые сохраняют ваши учетные данные входа в систему и любую информацию о пользователе безопасными и видимыми только вам.

Чтобы получить лексемы доступа для вашей учетной записи, программное обеспечение Simscape Multibody требует, чтобы вы вошли в свой аккаунт Onshape однажды на сеанс работы с MATLAB. Безопасная страница входа в систему Onshape открывается автоматически на первом использовании функции smexportonshape сеанса работы с MATLAB.

Можно отменить права доступа, предоставленные Средству экспорта Simscape Multibody в любое время. Необходимо, однако, восстановить те привилегии, если вы хотите экспортировать дополнительные модели Onshape. Если вы отменяете права доступа, то на вашем следующем использовании smexportonshape веб-страница Onshape открывает запрос вас принять или отклонить просьбу восстановить те привилегии.

multibodyDescriptionFile = smexportonshape(assemblyURL,Name,Value) добавляет аргумент пары "имя-значение", чтобы задать папку, в которой можно сохранить XML и файлы ШАГА для модели.

Примеры

свернуть все

Экспортируйте модель Onshape гуманоидного блока робота в текущую папку MATLAB с помощью функции smexportonshape. Затем импортируйте сгенерированные образцовые файлы в среду Simscape Multibody с помощью функции smimport.

  1. Сохраните URL модели Onshape в переменной MATLAB под названием url. URL должен всегда соответствовать вкладке блока Onshape, которую вы хотите экспортировать.

    url = 'https://cad.onshape.com/documents/5817806f96eae5105bfa5085/w/15ab3bfb58cacbf427d77ff3/e/181493813f84966648a8db1b';

  2. Экспортируйте гуманоидную модель робота использование функции smexportonshape. Сохраните имя сгенерированного файла описания мультитела в переменной под названием xmlFile. Вам можно предложить войти в ваш аккаунт Onshape.

    xmlFile = smexportonshape(url);

  3. Импортируйте модель в среду Simscape Multibody с помощью функции smimport. Программное обеспечение Simscape Multibody воссоздает модель Onshape как блок-схему.

    smimport(xmlFile);

  4. Обновите блок-схему. Mechanics Explorer открывается статической визуализацией модели в ее начальной настройке — одно соответствие с положением модели Onshape во время экспорта.

    Обратите внимание на то, что вертикальная ось робота (+Y) отличается от вертикальной оси по умолчанию, используемой в панели визуализации Mechanics Explorer (+Z). Чтобы ориентировать робота вертикально, выберите View> View convention> Y Up (XY Front). Выберите стандартное представление из меню View> Standard Views, чтобы активировать новое соглашение представления.

Экспортируйте модель Onshape гуманоидного блока робота в определенную папку с помощью функции smexportonshape.

  1. Сохраните URL модели Onshape в переменной MATLAB под названием url и папка, в которой можно сохранить модель в переменной под названием folder. Необходимо создать показанную папку или заменить ту папку на одну, которой у вас есть привилегии записи.

    url = 'https://cad.onshape.com/documents/5817806f96eae5105bfa5085/w/15ab3bfb58cacbf427d77ff3/e/181493813f84966648a8db1b';
folder = 'C:\Documents\Export'

  2. Экспортируйте гуманоидную модель робота использование функции smexportonshape. Используйте аргумент пары "имя-значение" FolderPath, чтобы задать папку экспорта. 

    xmlFile = smexportonshape(url, 'FolderPath', folder);

    Импортируйте модель в среду Simscape Multibody как перед использованием функции smimport. Обновите схему, чтобы визуализировать импортированную модель в Mechanics Explorer.

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

свернуть все

Веб-адрес модели блока Onshape, чтобы экспортировать. Функция использует этот адрес, чтобы получить доступ к модели блока и экспортировать его в формате, совместимом с программным обеспечением Simscape Multibody.

Чтобы получить URL, откройте модель блока Onshape, выберите вкладку блока и скопируйте URL с веб-браузера. Модель блока не должна принадлежать вашей учетной записи Onshape, если это совместно использовано с вами или обнародовано.

Пример: https://cad.onshape.com/documents/3e07ba43d290f9b924933ce8/w/eb80497ae2e1a3af0c4ce16d/e/f7903984700a200643fb6141

Типы данных: char | string

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: xmlFile = smexportonshape ('https://cad.onshape.com/documents/5817806f96eae5105bfa5085/w/15ab3bfb58cacbf427d77ff3/e/181493813f84966648a8db1b', 'FolderPath', 'C:\Documents\Export');

Путь папки, в которой можно сохранить XML и файлы ШАГА, сгенерированные во время образцового экспорта. Путь может быть абсолютным или относительным. У вас должны быть привилегии записи папке в порядке сохранить файлы там.

Пример: 'C:\Documents\Models'

Типы данных: char | string

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

свернуть все

Имя файла описания мультитела XML сгенерировано во время экспорта CAD Onshape. Имя выведено от имени сборки OnShape. Вы используете это имя в качестве аргумента в функции smimport, чтобы импортировать модель в среду Simscape Multibody.

Типы данных: char

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

Введенный в R2017a

Документация Simscape Multibody
Поддержка
Для просмотра документации необходимо авторизоваться на сайте