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.

Примеры

свернуть все

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

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

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

Внимание

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

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

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

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

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

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

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

Опция, чтобы возвратить ошибку, если новое имя существует на пути 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

Документация Simulink
Поддержка