save_system

Синтаксис

filename = save_system
filename = save_system(sys)
filename = save_system(sys,newsys)
filename = save_system(sys,newsys,Name,Value)

Описание

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

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

Если вы устанавливаете свойство модели UpdateHistory на UpdateHistoryWhenSave, никакая подсказка диалогового окна не появляется, когда вы используете save_system, чтобы сохранить модель. Если вы хотите обновить комментарий, используйте параметр 'ModifiedComment' с set_param перед сохранением, например:

set_param('mymodel','ModifiedComment','Here is my comment.')

пример

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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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 называет, чтобы экспортировать в, заданный в любой из этих форм (не чувствительный к регистру). Можно экспортировать в семь лет предыдущих релизов.

  • Выпустите имя, например, 'R2012A', 'R2016B'

  • Выпустите имя, сопровождаемое подчеркиванием и затем расширением, например, 'R2016A_SLX', 'R2014A_MDL'. Для релизов перед R2012a можно задать только к файлам .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, выбирают Saving the model. Эта настройка включена по умолчанию.

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

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

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

свернуть все

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

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

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