getRootInportMap

信号をルートレベルの Inport にマッピングするカスタムオブジェクトの作成

構文

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

説明

map = getRootInportMap('Empty'); は、空のマップオブジェクト map を作成します。このマップオブジェクトを使用して、空のカスタムマッピングオブジェクトを設定します。この関数を使用する前に、モデルを読み込んでください。最初にモデルを読み込まなかった場合、この関数は、モデルを読み込んでマッピングを作成し、その後にこのモデルを閉じます。

map = getRootInportMap(model,mdl,Name,Value); は、model と mdl で使うための、指定されたブロック名と信号名をもつマップオブジェクトを作成します。この関数を使用する前に、モデルを読み込んでください。最初にモデルを読み込まなかった場合、この関数は、モデルを読み込んでマッピングを作成し、その後にこのモデルを閉じます。このオブジェクトからマップする変数のコンマ区切りリストを作成するには、関数 getInputString を使用します。

map = getRootInportMap(inputmap,map,Name,Value); は、指定されたプロパティでマッピングオブジェクトをオーバーライドします。model、blockName、signalName のプロパティのみオーバーライドすることができます。この関数を使用する前に、モデルを読み込んでください。最初にモデルを読み込まなかった場合、この関数は、モデルを読み込んでマッピングを作成し、その後にこのモデルを閉じます。このオブジェクトからマップする変数のコンマ区切りリストを作成するには、関数 getInputString を使用します。

データをルートレベルの Inport にマッピングするカスタムマッピングモードを作成するときは、関数 getRootInportMap を使用します。カスタムマッピングアルゴリズムの例については、matlabroot/help/toolbox/simulink/examples にあるファイル例 BlockNameIgnorePrefixMap.m を参照してください。

入力引数

Empty

空のマップオブジェクトを作成します。

既定値: なし

名前と値の引数

オプションのコンマ区切りされた Name,Value の引数ペアを指定します。ここで、Name は引数名、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

model

ルート Inport のマップに関連付けられたモデル名

既定値: なし

blockName

ルートレベルの入力端子のブロック名。ツールは、ルート Inport ブロックの名前に基づいて、データを端子に割り当てます。ルート Inport ブロックの名前に一致する名前のデータ要素が検出されると、ツールはそのデータを対応する端子にマッピングします。

この引数は、次の値をとることができます。

ルートレベルの入力端子のブロック名。

ルートレベルの入力端子のブロック名を複数含んでいる cell 配列。

既定値: なし

signalName

マッピング対象の信号名。ツールは、端子の信号の名前に基づいて、データを端子に割り当てます。端子の信号名に一致する名前のデータ要素が検出されると、ツールはそのデータを対応する端子にマッピングします。

この引数は、次の値をとることができます。

マッピング対象の信号名。

マッピング対象の信号の信号名を複数含んでいる cell 配列。

既定値: なし

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]