getChildren

クラス: io.reader
名前空間: io

カスタムリーダーを使用してインポートされたデータの各ノードと信号に対するカスタムリーダーオブジェクトを返す

R2020b 以降

構文

childObj = getChildren(obj)

説明

childObj = getChildren(obj) は、カスタムファイルまたはワークスペースリーダーを使用してシミュレーションデータインスペクターにインポートされたデータの階層ノードと信号に対応するカスタムリーダーオブジェクトの配列を返します。getChildren メソッドを使用してインポートされたデータの階層を保持します。ファイルから複数の信号をインポートする場合、getChildren メソッドを使用して、ファイルに対応する最上位ノードの下に含まれている信号のフラットリストとしてデータをインポートします。

入力引数

すべて展開する

`obj` — カスタムデータリーダー
`io.reader` サブクラスオブジェクト

カスタムデータリーダー。io.reader 基底クラスから継承されるクラスのオブジェクトとして指定します。

例: MyCustomFileReader

出力引数

すべて展開する

`childObj` — 階層ノードと信号
`io.reader` サブクラスオブジェクトの cell 配列

インポートされたデータ内の階層ノードと信号。io.reader サブクラスオブジェクトの cell 配列として返されます。

例

すべて展開する

ファイルからインポートされた構造体データ

この例では getChildren メソッドを使用して、ファイルを表す最上位ノードに含まれている信号のフラットリストとしてファイルから複数の信号をインポートします。クラス定義ファイル内で getChildren メソッドのコードを指定します。

この例では完全なクラス定義は示しません。すべてのカスタムリーダーは getName、getTimeValues、および getDataValues メソッドの動作を定義しなければなりません。完全なクラス定義およびインポートワークフローを示す例については、カスタムファイルリーダーを使用したデータのインポートを参照してください。

この例では、getChildren メソッドは関数 readtable を使用してファイルからデータを読み取ります。この例のカスタムリーダーは最初の列のデータを常に時間として使用するため、最初の変数名はクリアされ、使用されません。getChildren メソッドは、ファイルおよびファイル内の各信号に対応する最上位レベルのノードのカスタムリーダーオブジェクトを作成し、値を FileName プロパティと VariableName プロパティに代入します。

classdef ExcelFirstColumnTimeReader < io.reader
  methods
    % ...

    function childObj = getChildren(obj)
      childObj = {};
      if isempty(obj.VariableName)
        t = readtable(obj.FileName);
        vars = t.Properties.VariableNames;
        vars(1) = [];
        childObj = cell(size(vars));
        for idx = 1:numel(vars)
            childObj{idx} = ExcelFirstColumnTimeReader;
            childObj{idx}.FileName = obj.FileName;
            childObj{idx}.VariableName = vars{idx};
        end
      end
    end
    
  % ...
  end
end

ワークスペースからインポートされた構造体データ

この例では getChildren メソッドを使用してベースワークスペースの変数に保存された構造体の配列をインポートします。クラス定義ファイル内で getChildren メソッドのコードを指定します。

この例では完全なクラス定義は示しません。すべてのカスタムリーダーは getName、getTimeValues、および getDataValues メソッドの動作を定義しなければならず、ワークスペースデータリーダーは supportsVariable メソッドを定義しなければなりません。ワークスペースデータリーダーの完全なクラス定義およびインポートワークフローを示す例については、カスタムデータリーダーを使用したワークスペース変数のインポートを参照してください。

この例では、getChildren メソッドは、変数が構造体の配列の場合、入力変数の各構造体のカスタムリーダーオブジェクトを作成します。この例のワークスペースリーダーは、作成する各オブジェクトを識別するために getChildren メソッドで使用する ChannelIndex プロパティを定義します。

classdef SimpleStructReader < io.reader
  
  properties
    ChannelIndex
  end

  methods
    % ...

    function childObj = getChildren(obj)
      childObj = {};
      if ~isscalar(obj.VariableValue) && isempty(obj.ChannelIndex)
        numChannels = numel(obj.VariableValue);
        childObj = cell(numChannels,1);
        for idx = 1:numChannels
            childObj{idx} = SimpleStructReader;
            childObj{idx}.VariableName = sprintf('%s(%d)',obj.VariableName,idx);
            childObj{idx}.VariableValue = obj.VariableValue;
            childObj{idx}.ChannelIndex = idx;
        end
      end
    end
    
  % ...
  end
end