ルート Inport のマッピングの信号データの作成

ルート Inport マッパーツールを使用する最初のステップは、インポートおよびマッピングする信号データのソースを特定することです。既存のデータ (たとえば Microsoft^® Excel^® スプレッドシート内の) を使用して MAT ファイルにデータを作成することも、信号エディターのインターフェイスを使用して信号データを作成することもできます。

ルート Inport マッパーツールの使用に関連するその他のステップの概要については、インポートおよびマッピングのワークフローを参照してください。

インポートしてマッピングするデータのソースの選択

データは次のソースからインポートできます。

ベースワークスペース — ベースワークスペースからデータを選択してインポートできます。サポートされているデータ形式の詳細については、ベースワークスペースと MAT ファイルの形式の選択を参照してください。
データファイル — MAT ファイルと Microsoft Excel ファイルに含まれている信号を選択してインポートできます。ファイルの内容をインポートするたびに、この内容によってルート Inport マッパーツールで既に読み込まれているファイルのデータがオーバーライドされます。
詳細については、ベースワークスペースと MAT ファイルの形式の選択およびSupported Microsoft Excel File Formatsを参照してください。
ヒント
シミュレーションの入力データを Microsoft Excel スプレッドシートから読み込む場合は、From Spreadsheet ブロックの使用を検討してください。シミュレーション中に、From Spreadsheet ブロックはスプレッドシートのデータを段階的に読み込みます。From Spreadsheet ブロックを使用する場合、シートの値への変更を処理するために何もする必要はありません。

信号エディターのインターフェイスを使用して信号データを作成および編集することもできます。詳細については、信号データの作成と編集を参照してください。

信号およびバスの命名規則の選択

インポートする信号を識別するときは、このデータのグループ化 (シナリオ) が相互交換可能になるような信号およびバスの命名規則の使用を検討してください。たとえば、命名規則に従って名付けられた同じ変数セットを持つ 2 つの MAT ファイルは、異なるデータ値を持つことができます。そして、モデルへの入力データおよびモデルからの入力データのシナリオを簡単に切り替えることができます。

ベースワークスペースと MAT ファイルの形式の選択

ルート Inport マッパーツールは MATLAB^® データ型またはインポートされた信号データのテーブルで説明されている形式をサポートしています。各データ型について、Choose Map Modeで示されているマッピングモードを使用できます。

メモ

ルート Inport マッパーツールでサポートされない形式のデータが MAT ファイルまたはベースワークスペースに含まれている場合、データは無視されます。

メモ

ルート Inport マッパーツールがこれらの形式を受け入れたとしても、Simulink.SimulationData.Dataset オブジェクトでリンクするだけの場合があります。MAT ファイル内のデータを Simulink.SimulationData.Dataset オブジェクトに変換するには、[ルート Inport マッパー] ダイアログボックスで [信号をシナリオデータセットに変換して MAT ファイルに保存] チェックボックスをオンにします。あるいは、関数 convertToSLDataset を使用してデータを変換します。

メモ

timetable を Dataset またはバスの要素として指定するとき、timetable には 1 つの信号のみのデータを含めなければなりません。

データセットの信号データ

データセットに一意ではない要素名が付けられている場合、[端子の順序] マッピングモードを使用します。マッピングモードの詳細については、Map Modeを参照してください。

MATLAB 時系列信号データ

列挙データを含む MATLAB timeseries データがあり、列挙クラスが MATLAB パス上にない場合、その timeseries データは無視されます。

構造体の信号データ

構造体信号データをデータセットに変換する場合、信号の名前は、構造体信号の信号フィールドのラベルフィールドに含まれる値を使用して付けられます。

配列の信号データ

ルート Inport マッパーツールは、データ配列を単一の入力端子にマッピングしようとします。この場合、どのマッピングモードでも選択できます。

ルート Inport のマッピング用のバスの信号データ

ルートレベルの Inport ブロックにインポートおよびマッピングする信号データには、バスデータを含めることができます。バス信号をルートレベルの Enable ブロックまたは Trigger ブロックにマッピングすることはできません。

MATLAB ワークスペースで、インポートおよびマッピングするバスデータのバスオブジェクトを作成するか読み込みます。
バスオブジェクトをベースワークスペースに作成する場合は、バスオブジェクトの定義を MAT ファイルに保存します (d_myBusObj.mat など)。
バスオブジェクトに対し、インポートするバスデータを含む別の MAT ファイルを作成します。次のいずれかの方法を使用します。
- MATLAB 構造体または Simulink.SimulationData.Dataset オブジェクトが既に含まれている既存の MAT ファイルを使用します。
- ベースワークスペース内でバスを作成して、それを MAT ファイルに保存します。
バスオブジェクトを読み込むようにモデルを設定します。
- 信号のマッピング先のルートレベルの Inport ブロックの場合は、[データ型] フィールドを [バス] に設定します。信号のマッピングに使用するバスオブジェクトの変数の名前を指定します。
- マッピングに使用するバスオブジェクトを含む MAT ファイルをモデルに読み込みます。たとえば、コールバック関数 PreLoadFcn を使用します。詳細については、マッピングデータ読み込みの代替ワークフローを参照してください。

ルート Inport のマッピング用の信号データの MAT ファイルでの作成

信号データを MAT ファイルで作成して、ルート Inport のマッピングで使用できます。たとえば、3 つの信号 (signal1、signal2 および signal3) をインポートして、信号を MAT ファイルで保存できます。Simulink.SimulationData.Signal オブジェクトには、信号名、ブロック名、ブロックパスおよび端子の順序インデックス値が含まれます。

関数 convertToSLDataset を使用して MAT ファイルの内容を Simulink.SimulationData.Dataset オブジェクトに変換できます。

MATLAB で、3 つの Simulink.SimulationData.Signal オブジェクトを作成して信号名、ブロックパスおよび端子の順序インデックス値を指定します。

signal1 = Simulink.SimulationData.Signal;
signal1.Name = 'signal1';
signal1.BlockPath = Simulink.SimulationData.BlockPath('Out1');
signal1.PortType = 'inport';
signal1.PortIndex = 1;

signal2 = Simulink.SimulationData.Signal;
signal2.Name = 'signal2';
signal2.BlockPath = Simulink.SimulationData.BlockPath('Out2');
signal2.PortType = 'inport';
signal2.PortIndex = 2;

signal3 = Simulink.SimulationData.Signal;
signal3.Name = 'signal3';
signal3.BlockPath = Simulink.SimulationData.BlockPath('Out3');
signal3.PortType = 'inport';
signal3.PortIndex = 3;

MATLAB ワークスペースで、signal1、signal2 および signal3 を選択します。選択を右クリックして、コンテキストメニューで [名前を付けて保存] をクリックします。ファイルを mySigData.mat として保存します。

MAT ファイルを開きます。

open mySigData.mat

ans = 

    signal1: [1x1 Simulink.SimulationData.Signal]
    signal2: [1x1 Simulink.SimulationData.Signal]
    signal3: [1x1 Simulink.SimulationData.Signal]

この MAT ファイルでは、[信号名]、[ブロック名]、[ブロックパス] または [端子の順序] マッピングモードを使用できます。マッピングモードに基づいて、ルート Inport マッパーツールは MAT ファイルの信号データを対応する端子にマッピングします。