Exponenta Banner

getRootInportMap

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

Свернуть все на странице

Синтаксис

map = getRootInportMap('Empty');
map = getRootInportMap(model,mdl,Name,Value);
map = getRootInportMap(inputmap,map,Name,Value);

Описание

map = getRootInportMap('Empty'); создает пустой объект карты, map. Используйте этот объект map для настройки пустого пользовательского объекта отображение. Загрузите модель перед использованием этой функции. Если вы не загружаете модель сначала, функция загружает модель, чтобы сделать отображение, а затем закрывает модель после.

map = getRootInportMap(model,mdl,Name,Value); создает объект map для model, mdl, с указанными именами блоков и сигналами. Загрузите модель перед использованием этой функции. Если вы не загружаете модель сначала, функция загружает модель, чтобы сделать отображение, а затем закрывает модель после. Чтобы создать список , разделенный запятыми переменных для отображения из этого объекта, используйте getInputString функция.

map = getRootInportMap(inputmap,map,Name,Value); переопределяет объект отображения с заданным свойством. Можно переопределить только свойства model, blockName, и signalName. Загрузите модель перед использованием этой функции. Если вы не загружаете модель сначала, функция загружает модель, чтобы сделать отображение, а затем закрывает модель после. Чтобы создать список , разделенный запятыми переменных для отображения из этого объекта, используйте getInputString функция.

Используйте getRootInportMap функция при создании пользовательского режима отображения для сопоставления данных с входными портами корневого уровня. См. файл примера BlockNameIgnorePrefixMap.m, расположен в matlabroot/ help/toolbox/simulink/examples, для примера пользовательского алгоритма отображения.

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

Empty

Создайте пустой объект карты.

По умолчанию: нет

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

'model'

Имя модели для связи с корневой картой входных портов.

По умолчанию: Нет

'blockName'

Имена блоков входных портов корневого уровня. Инструмент присваивает данные портам в соответствии с именем блока root-inport. Если инструмент находит элемент данных, имя которого совпадает с именем блока root-inport, он сопоставляет данные с соответствующим портом.

Значение этого аргумента может быть:

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

По умолчанию: Нет

'signalName'

Имена сигналов, которые будут отображены. Инструмент присваивает данные портам в соответствии с именем сигнала на порту. Если инструмент находит элемент данных, имя которого совпадает с именем сигнала в порту, он сопоставляет данные с соответствующим портом.

Значение этого аргумента может быть:

Имя сигнала, который будет отображен.
Массив ячеек, содержащий несколько имен сигналов, которые будут отображены.

По умолчанию: Нет

'inputmap'

Имя объекта отображения, подлежащего переопределению.

По умолчанию: Нет

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

map

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

Примеры

свернуть все

Создайте пустой пользовательский объект отображения.

map = getRootInportMap('Empty')
map = 

  1x0 InputMap array with properties:

    Type
    DataSourceName
    Destination

Создайте простой объект отображения с помощью MATLAB® объект временных рядов.

Создайте объект временных рядов, signalIn1.

signalIn1 = timeseries((1:10)')
Common Properties:
            Name: 'unnamed'
            Time: [10x1 double]
        TimeInfo: [1x1 tsdata.timemetadata]
            Data: [10x1 double]
        DataInfo: [1x1 tsdata.datametadata]

Создайте объект отображения для объекта временных рядов для модели, ex_minportsOnlyModel.

modelFile = fullfile(matlabroot,'help','toolbox','simulink',...
'examples','ex_minportsOnlyModel');
load_system(modelFile);
map = getRootInportMap('model','ex_minportsOnlyModel',...
'blockName','In1','signalname','signalIn1')
map = 

  InputMap with properties:

              Type: 'Inport'
    DataSourceName: 'signalIn1'
       Destination: [1x1 Simulink.iospecification.Destination]

Создайте объект отображения, используя векторы имен блоков и имен сигналов для модели ex_minportsOnlyModel.

Создайте объект отображения векторов.

modelFile = fullfile(matlabroot,'help','toolbox','simulink',...
'examples','ex_minportsOnlyModel');
load_system(modelFile);
map = getRootInportMap('model','ex_minportsOnlyModel',...
'blockName',{'In1' 'In2'}, ...
'signalname',{'signalIn1' 'signalIn2'})
map = 

  1x2 InputMap array with properties:

    Type
    DataSourceName
    Destination

Создайте объект отображения, который содержит var2 сигнала, затем переопределите var2 на var1.

Создайте объект отображения векторов.

% Load the model and define variables
modelFile = fullfile(matlabroot,'help','toolbox','simulink',...
'examples','ex_minportsOnlyModel');
load_system(modelFile);
modelValue = 'ex_minportsOnlyModel';
blockNameValue = 'In1';
signalNameValue = 'var2';
portType = 'Inport';

% Define var1 and override var2 with var1
signalNameToOverload = 'var1';
mapToOverload = getRootInportMap('model',modelValue,...
'blockName',blockNameValue,...
 'signalName',signalNameToOverload)
mapToOverload = 

  InputMap with properties:

              Type: 'Inport'
    DataSourceName: 'var1'
       Destination: [1x1 Simulink.iospecification.Destination]

Совет

  • Загрузите модель перед запуском этой функции.

  • Если ваш пользовательский режим отображения аналогичен существующему Simulink® режим отображения, рассмотрите использование getSlRootInportMap вместо этого функция.

См. также

|

Темы

Введенный в R2012b

Документация Simulink

Поддержка