exponenta event banner

Simulink. VariableUsage

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

Описание

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

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

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

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

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

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

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

Только a 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'

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

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

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

Примеры

свернуть все

Вернуть a 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