Simulink.VariableUsage

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

Описание

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

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

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

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

  • Подготовьтесь к разбиению переменных и настройте владение переменной при работе в команде.

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

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

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

Создание

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

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

Описание

пример

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'

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

Блоки, которые используют переменную или модели, которые используют перечисленный тип, возвращенные как массив ячеек из векторов символов. Каждый вектор символов называет блок или модель, которая использует переменный или перечисленный тип. The 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