Exponenta Banner
exponenta event banner

save_system

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

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

Синтаксис

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.

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

свернуть все

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

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

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

Для получения информации о правилах для именования моделей смотрите Имена модели.

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

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

Пример: save_system ('mymodel', 'newmodel', 'SaveModelWorkspace', верный, 'BreakUserLinks', верный, 'OverwriteIfChangedOnDisk', верный)

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

Опция к, в сохраненном файле, заменяет ссылки на блоки библиотеки с копиями блоков библиотеки, заданных как true, false, 'on' или 'off'. Эта опция влияет на пользовательские блоки и блоки Библиотеки Simulink.

Внимание

Опция 'BreakAllLinks' может привести к проблемам совместимости при обновлении до более новых версий Simulink. Например:

  • Любые маски сверху ссылок библиотеки на S-функции Simulink не обновляют до новой версии S-функции.

  • Любые ссылки библиотеки на подсистемы маскированные в Библиотеке Simulink не обновляют до нового поведения подсистемы.

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

Если вы сохранили модель с неработающими ссылками на встроенные библиотеки, используйте Советника по вопросам Обновления, чтобы отсканировать модель для устаревших блоков. Затем обновите блоки Simulink до их текущих версий.

Опция к, в сохраненном файле, заменяет ссылки на пользовательские блоки библиотеки с копиями блоков библиотеки, заданных как true, false, 'on' или 'off'.

Опция к, в сохраненном файле, заменяет ссылки на встроенные блоки библиотеки с копиями блоков библиотеки, заданных как true, false, 'on' или 'off'. Эта опция влияет на блоки Библиотеки Simulink и блоки от библиотек, предоставленных тулбоксами MathWorks® или blocksets.

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

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

Пример: save_system ('mymodel', 'exportfile.xml', 'ExportToXML', верный)

Релиз 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. В Образцовой панели Файла диалогового окна Simulink Preferences, в соответствии с Уведомлением об Изменении, выбирают Saving модель. Эта настройка включена по умолчанию.

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

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

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

свернуть все

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

Примеры

свернуть все

Создайте модель. 

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)

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

| | |

Темы

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

Была ли эта тема полезной?
Документация Simulink
Поддержка