exponenta event banner

save_system

Сохранить модель Simulink

Описание

filename = save_system сохраняет текущую модель верхнего уровня. Если модель не была сохранена ранее, save_system создает файл в текущей папке.

Чтобы сохранить подсистему, используйте вместо этого Simulink.SubSystem.copyContentsToBlockDiagram для копирования содержимого подсистемы в новую модель. Затем эту модель можно сохранить с помощью save_system. Посмотрите Simulink.SubSystem.copyContentsToBlockDiagram.

пример

filename = save_system(sys) сохраняет модель sys. Модель должна быть открытой или загруженной.

пример

filename = save_system(sys,newsys) сохранение модели в новом файле newsys. Если внутренний номер не указан, то save_system использует формат файла, указанный в настройках Simulink ®.

пример

filename = save_system(sys,newsys,Name,Value) сохраняет систему с дополнительными опциями, заданными одним или несколькими Name,Value аргументы пары. Использовать Name,Value пары без сохранения в новый файл, использовать [] для newsys.

Примеры

свернуть все

Создание модели.

new_system('newmodel')

Сохраните модель.

save_system('newmodel')

Открытие модели vdp. Сохранение в модели с именем myvdp в текущей папке. Без расширения файла функция сохраняет модель в формате, заданном в настройках Simulink.

open_system('vdp')
save_system('vdp','myvdp')

После сохранения модели под другим именем она больше не будет открыта под исходным именем. Открытый vdp снова и сохраните его как .mdl в текущей папке.

open_system('vdp')
save_system('vdp','mynewvdp.mdl')

Сохраните модель с новым именем и верните ошибку, если в пути MATLAB ® существует что-либо с таким именем. В этом случае save_system отображает ошибку, поскольку max - имя функции MATLAB. Модель не сохранена.

open_system('vdp')
save_system('vdp','max','ErrorIfShadowed',true)
Error using save_system (line 38)
The model 'vdp' cannot be saved with the new name 'max', because this name is
shadowing another name on the MATLAB path or in the workspace.  Choose another
name, or do not use the option 'ErrorIfShadowed'

Предположим, что у вас есть модель с именем mymodel. Откройте модель и сохраните ее в модели с именем newmodel. Также сохраните рабочее пространство модели, разорвать связи с пользовательскими блоками библиотеки и перезаписать, если файл изменился на диске.

open_system('mymodel')
save_system('mymodel','mynewmodel','SaveModelWorkspace', 
true,'BreakUserLinks',true,'OverwriteIfChangedOnDisk',true)

Сохранение модели mymodelразрыв связей с пользовательскими блоками библиотеки в модели.

save_system('mymodel',[],'BreakUserLinks',true)

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

свернуть все

Имя сохраняемой модели, указанное как символ, массив ячеек векторов символов, строковый массив, дескриптор или массив дескрипторов. Не используйте расширение файла.

Файл для сохранения, указанный как символьный вектор, массив ячеек символьных векторов, строковый массив или, для использования Name,Value пары без изменения имени файла, []. Можно указать имя модели в текущей папке или полный путь с расширением или без него.

Без внутреннего номера, save_system сохраняет в формате, указанном в настройках Simulink. Возможные расширения модели: .slx и .mdl. С помощью 'ExportToXML' опция, используйте расширение .xml.

Сведения о правилах именования моделей см. в разделе Имена моделей.

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: save_system('mymodel','newmodel','SaveModelWorkspace',true,'BreakUserLinks',true,'OverwriteIfChangedOnDisk',true)

Параметр, разрешающий запросы в диалоговом окне, указанный как true, false, 'on', или 'off'. По умолчанию в командной строке появляются предупреждения и сообщения об ошибках.

Параметр для возврата ошибки, если новое имя существует в пути или рабочей области MATLAB, указанном как true, false, 'on', или 'off'.

Опция экспорта модели в файл в простом формате XML, указанная как true, false, 'on', или 'off'. Укажите полное имя файла, включая .xml расширение. Блок-схема в памяти не изменяется и обратные вызовы не выполняются. Использовать этот параметр без другого Name,Value аргументы пары. Этот параметр предупреждает и будет удален в следующей версии.

Пример: save_system('mymodel','exportfile.xml','ExportToXML',true)

Имя версии MATLAB для экспорта, указанное в любой из этих форм (без учета регистра). Можно экспортировать в семь лет предыдущих версий.

  • Имя выпуска, например, 'R2013B', 'R2016B'

  • Имя выпуска, за которым следует знак подчеркивания, а затем расширение, например: 'R2016A_SLX', 'R2014A_MDL'. Если расширение не указано, выполняется экспорт в формат файла, заданный в настройках Simulink.

save_system экспортирует систему таким образом, чтобы указанная версия Simulink могла загрузить ее. Если система содержит функциональные возможности, не поддерживаемые указанной версией Simulink, команда удаляет функциональные возможности из экспортированного файла. Он также заменяет неподдерживаемые блоки пустыми маскированными блоками подсистем, окрашенными в желтый цвет. В результате экспортированная система может генерировать другие результаты.

В качестве альтернативы можно использовать Simulink.exportToVersion или интерактивное диалоговое окно Экспорт в предыдущую версию (Export to Previous Version).

Сведения об экспорте проекта в предыдущие версии см. в разделе Экспорт проекта в предыдущую версию.

Параметр перезаписи файла на диске, даже если он был изменен с момента загрузки системы, указан как true, false, 'on', или 'off'. По умолчанию, если файл изменился на диске с момента загрузки модели, save_system отображает ошибку, препятствующую перезаписи изменений на диске.

Вы можете управлять, save_system отображает ошибку, если файл был изменен на диске с помощью настройки Simulink. На панели Файл модели (Model File) диалогового окна Настройки симулятора (Simulink Preferences) в разделе Уведомление об изменении (Change Notification) выберите Сохранить модель (Save the model). Эта настройка включена по умолчанию.

Опция сохранения ссылочных моделей с несохраненными изменениями при сохранении изменений родительской модели, указанная как true, false, 'on', или 'off'. Эта опция применяется к моделям, на которые непосредственно ссылается каждая сохраненная модель. Если родительская модель грязной ссылочной модели не сохранена, грязная ссылочная модель не сохраняется.

Предположим, что у вас есть иерархия модели, в которой модель A ссылочная модель Bи модель B ссылочная модель C. Если модели B и C оба имеют несохраненные изменения, они оба сохранены. Если модель C имеет несохраненные изменения, но модель B не имеет несохраненных изменений, модель не сохраняется.

По умолчанию попытка сохранить модель, содержащую несохраненные ссылочные модели, возвращает ошибку.

Опция для сохранения содержимого рабочего пространства модели, указанного как true, false, 'on', или 'off'. Рабочее пространство модели DataSource должен быть MAT-файлом. Если источник данных не является MAT-файлом, save_system не сохраняет рабочую область. См. раздел Указание источника данных в рабочей области модели.

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

свернуть все

Полное имя сохраненного файла, возвращаемого в виде символьного вектора или массива ячеек символьных векторов.

Представлен до R2006a