Main Content

readMember

アンサンブル メンバー データをメンバー インデックスに基づいて返す

R2020a 以降

説明

readMember は、診断特徴デザイナーで生成されたコードで使用される関数です。

data = readMember(wensemble,index) は、index で識別されるワークスペース アンサンブル wensemble メンバーを読み取り、メンバー データを data で返します。readMember は、wensemble'SelectedVariables' プロパティで指定された変数のみを読み取ります。

診断特徴デザイナーで生成されるコードでは、次の条件で writeMemberreadMember、および findIndex が使用されます。

  • 入力データがファイルまたはシミュレーション アンサンブル データストアなどのアンサンブル データストアである。

  • コード生成時の計算オプションで、結果をアンサンブル データストアに書き戻すのではなく、結果をローカル メモリに格納するように指定している。

コードで workspaceEnsemble オブジェクトを使用して管理しているローカル バージョンのデータ内での読み取りと書き込みの際にメンバー インデックスを明示的に指定すると、元のアンサンブル データストアとのメンバーの同期が確実に維持されます。この同期は、信号の残差を計算する前処理としてアンサンブルの統計を計算する場合など、逐次的なメンバーの処理ループがある場合に必要です。

  • 空のアンサンブルから始まる最初のメンバーの処理ループでは、インデックス付けは必要ありません。それぞれの新しいメンバーの結果がアンサンブルの最後にコードによって追加されます。

  • 2 番目のループでは、インデックスにより、更新されたメンバーの結果を現在取り込まれているアンサンブル内の正しい位置にコードで書き込むことができます。

アンサンブルの統計の二重処理ループの詳細については、アプリで生成された MATLAB コードの構造を参照してください。

入力引数

すべて折りたたむ

アンサンブル オブジェクト。workspaceEnsemble オブジェクトとして指定します。wensemble はアンサンブル データを格納し、データ変数や状態変数など、アンサンブル内の変数の名前と型を指定します。

メンバー インデックス。正の整数として指定します。新しいデータを読み取るアンサンブル メンバーが index で識別されます。

出力引数

すべて折りたたむ

readMember で抽出されたメンバー データ。単一行の table として返されます。

バージョン履歴

R2020a で導入