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 или в интерактивном режиме диалоговое окно Экспорт в предыдущую версию.

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

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

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

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

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

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

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

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

свернуть все

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

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