Simulink.fileGenControl

Задайте корневые папки для файлов, сгенерированных обновлениями схемы и сборками модели

Синтаксис

cfg = Simulink.fileGenControl('getConfig')
Simulink.fileGenControl(Action,Name,Value)

Описание

пример

cfg = Simulink.fileGenControl('getConfig') возвращает указатель на экземпляр объекта Simulink.FileGenConfig, который содержит текущие значения этих параметров управления генерацией файла:

  • CacheFolder – Задает корневую папку для артефактов сборки модели, которые используются для симуляции, включая файлы кэша Simulink®.

  • CodeGenFolder – Задает корневую папку для файлов генерации кода.

  • CodeGenFolderStructure – Управляет структурой папок в папке генерации кода.

Чтобы получить или установить значения параметров, используйте объект Simulink.FileGenConfig.

Эти настройки Simulink® определяют начальные значения параметров для сеанса MATLAB®:

пример

Simulink.fileGenControl(Action,Name,Value) выполняет действие, которое использует параметры управления генерацией файла текущего сеанса работы с MATLAB. Задайте дополнительные опции с одним или несколькими аргументами пары name,value.

Примеры

свернуть все

Чтобы получить генерацию файла управляют значениями параметров для текущего сеанса работы с MATLAB, используют getConfig.

cfg = Simulink.fileGenControl('getConfig');

myCacheFolder = cfg.CacheFolder;
myCodeGenFolder = cfg.CodeGenFolder;
myCodeGenFolderStructure = cfg.CodeGenFolderStructure;

Чтобы установить генерацию файла управляют значениями параметров для текущего сеанса работы с MATLAB, используют действие setConfig. Во-первых, установите значения в экземпляре объекта Simulink.FileGenConfig. Затем передайте экземпляр объекта. Этот пример принимает, что ваша система имеет папки aNonDefaultCacheFolder и aNonDefaultCodeGenFolder.

% Get the current configuration
cfg = Simulink.fileGenControl('getConfig');

% Change the parameters to non-default locations
% for the cache and code generation folders
cfg.CacheFolder = fullfile('C:','aNonDefaultCacheFolder');
cfg.CodeGenFolder = fullfile('C:','aNonDefaultCodeGenFolder');
cfg.CodeGenFolderStructure = 'TargetEnvironmentSubfolder';

Simulink.fileGenControl('setConfig', 'config', cfg);

Можно установить значения параметров управления генерацией файла для текущего сеанса работы с MATLAB, не создавая экземпляр объекта Simulink.FileGenConfig. Этот пример принимает, что ваша система имеет папки aNonDefaultCacheFolder и aNonDefaultCodeGenFolder.

myCacheFolder = fullfile('C:','aNonDefaultCacheFolder');
myCodeGenFolder = fullfile('C:','aNonDefaultCodeGenFolder');

Simulink.fileGenControl('set', 'CacheFolder', myCacheFolder, ...
   'CodeGenFolder', myCodeGenFolder, ...
   'CodeGenFolderStructure', ...
    Simulink.filegen.CodeGenFolderStructure.TargetEnvironmentSubfolder);

Если вы не хотите генерировать код для различных целевых окружений в отдельных папках для 'CodeGenFolderStructure', задайте значение Simulink.filegen.CodeGenFolderStructure.ModelSpecific.

Можно сбросить параметры управления генерацией файла к значениям от настроек Simulink.

Simulink.fileGenControl('reset');

Чтобы создать папки генерации файла, используйте действие set с опцией 'createDir'. Можно сохранить предыдущие папки генерации файла на пути MATLAB через опцию 'keepPreviousPath'.

% 
myCacheFolder = fullfile('C:','aNonDefaultCacheFolder');
myCodeGenFolder = fullfile('C:','aNonDefaultCodeGenFolder');

Simulink.fileGenControl('set', ...
   'CacheFolder',myCacheFolder, ...
   'CodeGenFolder',myCodeGenFolder, ...
   'keepPreviousPath',true, ...
   'createDir',true);

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

свернуть все

Задайте действие, которое использует параметры управления генерацией файла текущего сеанса работы с MATLAB:

  • сброс Сбросьте параметры управления генерацией файла к значениям от настроек Simulink.

  • Набор Установите параметры управления генерацией файла для текущего сеанса работы с MATLAB непосредственно передающими значениями.

  • 'setConfig' – Установите параметры управления генерацией файла для текущего сеанса работы с MATLAB при помощи экземпляра объекта Simulink.FileGenConfig.

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

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

Пример: Simulink.fileGenControl(Action, Name, Value);

Задайте экземпляр объекта Simulink.FileGenConfig, содержащий параметры управления генерацией файла, которые вы хотите установить.

Опция для setConfig.

Пример: Simulink.fileGenControl('setConfig', 'config', cfg);

Задайте значение пути к папке кэша симуляции для параметра CacheFolder.

Опция для set.

Пример: Simulink.fileGenControl('set', 'CacheFolder', myCacheFolder);

Задайте значение пути к папке генерации кода для параметра CodeGenFolder. Можно задать абсолютный путь или путь относительно папок сборки. Например:

  • 'C:\Work\mymodelsimcache' и '/mywork/mymodelgencode' задают абсолютные пути.

  • 'mymodelsimcache' является путем относительно текущей рабочей папки (pwd). Программное обеспечение преобразовывает относительный путь в полностью определенный путь в то время CacheFolder, или параметр CodeGenFolder устанавливается. Например, если pwd является '/mywork', результатом является '/mywork/mymodelsimcache'.

  • '../test/mymodelgencode' является путем относительно pwd. Если pwd является '/mywork', результатом является '/test/mymodelgencode'.

Опция для set.

Пример: Simulink.fileGenControl('set', 'CodeGenFolder', myCodeGenFolder);

Задайте размещение подпапок в папке сгенерированного кода:

  • Simulink.filegen.CodeGenFolderStructure.ModelSpecific (значение по умолчанию) – Сгенерированный код места в подпапках в образцово-специфичной папке.

  • Модели Simulink.filegen.CodeGenFolderStructure.TargetEnvironmentSubfolder - If сконфигурированы для различных целевых окружений, помещают сгенерированный код для каждой модели в отдельной подпапке. Имя подпапки соответствует целевому окружению.

Опция для set.

Пример: Simulink.fileGenControl('set', 'CacheFolder', myCacheFolder, ... 'CodeGenFolder', myCodeGenFolder, ... 'CodeGenFolderStructure', ... Simulink.filegen.CodeGenFolderStructure.TargetEnvironmentSubfolder);

Задайте, сохранить ли предыдущие значения CacheFolder и CodeGenFolder на пути MATLAB:

  • tRUE Сохраните предыдущие значения пути к папке на пути MATLAB.

  • false (значение по умолчанию) – Удаляет предыдущие более старые значения пути из пути MATLAB.

Опция для reset, set или setConfig.

Пример: Simulink.fileGenControl('reset', 'keepPreviousPath', true);

Задайте, создать ли папки для генерации файла, если папки не существуют:

  • Папки true - Create для генерации файла.

  • false (значение по умолчанию) – не создает папки для генерации файла.

Опция для set или setConfig.

Пример: Simulink.fileGenControl('set', 'CacheFolder', myCacheFolder, 'CodeGenFolder', myCodeGenFolder, 'keepPreviousPath', true, 'createDir',true);

Избегайте конфликтов по совпадению имен

Используя Simulink.fileGenControl, чтобы установить CacheFolder и CodeGenFolder добавляет заданные папки в ваш путь поиска файлов MATLAB. Эта функция имеет тот же потенциал для представления конфликта по совпадению имен как использование addpath, чтобы добавить папки в путь поиска файлов. Например, конфликт по совпадению имен происходит, если папка, которую вы задаете для CacheFolder или CodeGenFolder, содержит образцовый файл с тем же именем как открытая модель. Для получения дополнительной информации смотрите то, Что Путь поиска файлов MATLAB? (MATLAB) и Файлы и Папки, что MATLAB доступы (к MATLAB).

Использовать местоположение не по умолчанию для папки кэша симуляции или папки генерации кода:

  1. Удалите любые потенциально конфликтные артефакты, которые существуют в:

    • Текущая рабочая папка, pwd.

    • Кэш симуляции не по умолчанию и папки генерации кода, которые вы намереваетесь использовать.

  2. Задайте местоположения не по умолчанию для кэша симуляции и папок генерации кода при помощи настроек Simulink или Simulink.fileGenControl.

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

свернуть все

Экземпляр объекта Simulink.FileGenConfig, который содержит текущие значения параметров управления генерацией файла.

Представленный в R2010b

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