Simulink. VariableUsage

Храните информацию об отношении между переменными и блоками в моделях

Описание

Объект Simulink.VariableUsage описывает, где переменная используется в моделях.

Используйте эту информацию для:

  • Подготовьтесь постоянно хранить переменные в файлах и рабочих областях. Для получения дополнительной информации о хранении переменных для модели, смотрите, Определяют, Где Сохранить Переменные и Объекты для Моделей Simulink.

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

  • Подготовьтесь делить переменные и устанавливать переменное владение, когда вы будете работать в команде.

Чтобы анализировать переменное использование в моделях, используйте объекты Simulink.VariableUsage вместе с функцией Simulink.findVars. Функция возвращает и принимает объекты Simulink.VariableUsage как аргументы. Для получения дополнительной информации смотрите Simulink.findVars.

Объект Simulink.VariableUsage может также описать использование перечислимого типа данных.

Только конструктор Simulink.VariableUsage или функция Simulink.findVars могут установить значения свойств в объекте Simulink.VariableUsage. Свойства в противном случае только для чтения.

Создание

Функция Simulink.findVars возвращает объекты Simulink.VariableUsage.

Чтобы создать переменные объекты использования для использования в качестве фильтра при использовании Simulink.findVars, используйте функцию Simulink.VariableUsage, описанную ниже.

Синтаксис

variableUsageObj = Simulink.VariableUsage(varNames,sourceName)

Описание

пример

variableUsageObj = Simulink.VariableUsage(varNames,sourceName) создает массив объектов Simulink.VariableUsage описать переменные varNames. Конструктор устанавливает свойство Name каждого объекта к одним из имен переменных, заданных varNames, и устанавливает свойство Source всех объектов к источнику, заданному sourceName. Можно задать varNames с переменными, которые не используются ни в каких загруженных моделях.

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

развернуть все

Имена целевых переменных, заданных как вектор символов или массив ячеек из символьных векторов. Конструктор создает объект Simulink.VariableUsage для каждого имени переменной.

Пример: 'k'

Пример: {'k','asdf','fuelFlow'}

Типы данных: char | cell

Имя источника, который задает целевые переменные, заданные как вектор символов. Например, можно задать базовое рабочее пространство MATLAB или словарь данных как источник. Конструктор также определяет и устанавливает свойство SourceType каждого из возвращенных объектов Simulink.VariableUsage.

Пример: 'base workspace'

Пример: 'myModel'

Пример: 'myDictionary.sldd'

Типы данных: char

Свойства

развернуть все

Это свойство доступно только для чтения.

Имя переменного или перечислимого типа данных объект описывает, возвращенный как вектор символов.

Это свойство доступно только для чтения.

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

Значение SourceЗначение
'base workspace'Базовое рабочее пространство MATLAB®
'MyModel'Рабочее пространство модели для модели MyModel
'MyModel/Mask1'Рабочая область маски для маскированного блока Mask1 в модели MyModel
'sldemo_fuelsys_dd_controller.sldd'Словарь данных под названием 'sldemo_fuelsys_dd_controller.sldd'

Таблица показывает некоторые примеры, если вы создали объект Simulink.VariableUsage при помощи функции Simulink.findVars, чтобы найти перечисленные типы данных.

Значение SourceЗначение
'BasicColors.m'Перечислимый тип задан в файле MATLAB 'BasicColors.m'.
''Перечислимый тип задан динамически и не имеет никакого источника.
'sldemo_fuelsys_dd_controller.sldd'Перечислимый тип задан в словаре данных под названием 'sldemo_fuelsys_dd_controller.sldd'.

Это свойство доступно только для чтения.

Тип рабочей области, которая задает переменную, возвратился как вектор символов. Возможные значения:

  • 'base workspace'

  • 'model workspace'

  • 'mask workspace'

  • 'data dictionary'

Если вы создали объект Simulink.VariableUsage при помощи функции Simulink.findVars, чтобы найти перечисленные типы данных, возможные значения:

  • 'MATLAB file'

  • 'dynamic class'

  • 'data dictionary'

Это свойство доступно только для чтения.

Блоки, которые используют переменную или модели, которые используют перечислимый тип, возвратились как массив ячеек из символьных векторов. Каждый вектор символов называет блок или модель, которая использует тип переменной или перечислимый тип. Функция Simulink.findVars заполняет это свойство.

Функции объекта

Примеры

свернуть все

Возвратите объект Simulink.VariableUsage для переменной k в базовом рабочем пространстве.

var = Simulink.VariableUsage('k','base workspace');

Можно использовать var в качестве фильтра для функции Simulink.findVars.

Возвратите массив объектов Simulink.VariableUsage, содержащих один объект для каждой переменной, возвращенной командой whos в базовом рабочем пространстве.

vars = Simulink.VariableUsage(whos,'base workspace')

Возвратите массив объектов Simulink.VariableUsage, который описывает все переменные в рабочем пространстве модели.

hws = get_param('mymodel','ModelWorkspace');
vars = Simulink.VariableUsage(hws.whos,'MyModel')

Возвратите массив объектов Simulink.VariableUsage, который описывает все переменные в рабочей области маски.

maskVars = get_param('mymodel/maskblock','MaskWSVariables');
vars = Simulink.VariableUsage(maskVars,'mymodel/maskblock');

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