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ложь, 'on', или 'off'. По умолчанию предупреждения и сообщения об ошибке появляются в командной строке.

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

Опция, чтобы экспортировать модель в файл в простом формате XML в виде trueложь, '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ложь, 'on', или 'off'. По умолчанию, если файл, измененный на диске начиная с модели, загрузился, save_system отображает ошибку предотвратить изменения на диске от того, чтобы быть перезаписанным.

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

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

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

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

свернуть все

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

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