Main Content

joindata

2 つのフレーム table を外部連結を使用してマージ

R2020a 以降

説明

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

table12 = joindata(table1,table2) は、最初の 2 列をマージの主キーとして、2 つの table を外部連結を使用してマージします。一般に、外部連結では、キー変数の値が一致する table の行を連結し、キー変数が一方の入力 table ともう一方の入力 table で一致しない行も残します (outerjoin を参照)。joindata は 2 つのフレーム table を結合します。両方のフレーム table の最初の 2 列に、セグメントの始点とセグメントの終点が格納されます。table のそれ以外の列には、フレームに関連付けられたデータが格納されます。データ列の名前は一意でなければならず、つまり、table1 のデータ列と同じ名前のデータ列が table2 にあってはなりません。

診断特徴デザイナーで生成されるコードでは、フレームベースのアンサンブル統計の処理を実行する際に joindata が使用されます。コードでは、table1 に既存のフレーム データが格納され、table2 に新しく計算されたフレーム結果が格納されます。

table12 = joindata(table1,table2,'Keys',keys) は、keys で指定された名前の列をマージの主キーとして使用します。たとえば、'Keys',["TimeStart","TimeEnd"] は、主キーに最初の 2 列を自動的に使用する代わりに、TimeStart および TimeEnd という名前の列を joindata で使用するように指定します。

すべて折りたたむ

オーバーラップする 2 つのフレーム table をマージします。

table1 として、4 つの連続する 5 秒のフレームでの変数 Var1 の値が格納された 4 行 3 列の table を作成します。

table1 = table(seconds(0:5:15)', seconds(5:5:20)', [3;4;5;6], ...
    'VariableNames', ["TimeStart", "TimeEnd", "Var1"])
table1=4×3 table
    TimeStart    TimeEnd    Var1
    _________    _______    ____

      0 sec       5 sec      3  
      5 sec      10 sec      4  
     10 sec      15 sec      5  
     15 sec      20 sec      6  

table2 として、table1 とフレームがオーバーラップする、同じく 4 行 3 列の table を作成します。table2 には Var2 の値が格納されます。

table2 = table(seconds(5:5:20)', seconds(10:5:25)', [1;2;3;4], ...
    'VariableNames', ["TimeStart", "TimeEnd", "Var2"])
table2=4×3 table
    TimeStart    TimeEnd    Var2
    _________    _______    ____

      5 sec      10 sec      1  
     10 sec      15 sec      2  
     15 sec      20 sec      3  
     20 sec      25 sec      4  

TimeStartTimeEnd をマージ キーとして使用して 2 つの table をマージします。

table12 = joindata(table1, table2, 'Keys', ["TimeStart", "TimeEnd"])
table12=5×4 table
    TimeStart    TimeEnd    Var1    Var2
    _________    _______    ____    ____

      0 sec       5 sec       3     NaN 
      5 sec      10 sec       4       1 
     10 sec      15 sec       5       2 
     15 sec      20 sec       6       3 
     20 sec      25 sec     NaN       4 

table12 は、各フレームの Var1Var2 の値が格納された 5 行 4 列の table になります。欠損値は NaN で表されます。

入力引数

すべて折りたたむ

マージする 1 つ目のフレーム table。最初の 2 列がセグメントの始点と終点を表し、残りの列に対応するデータが格納された table として指定します。

マージする 2 つ目のフレーム table。最初の 2 列がセグメントの始点と終点を表し、残りの列に対応するデータが格納された table として指定します。データ列の名前は、table1 のいずれのデータ列の名前とも一致してはなりません。

table のマージの主キー。'Keys' と 2 つの string を含む string 配列か 2 つの文字配列の cell のいずれかで構成されるコンマ区切りのペアとして指定します。

出力引数

すべて折りたたむ

マージされたフレーム データ。table として返されます。

バージョン履歴

R2020a で導入