ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

addvars

変数を table または timetable に追加

構文

T2 = addvars(T1,var1,...,varN)
T2 = addvars(T1,var1,...,varN,'Before',location)
T2 = addvars(T1,var1,...,varN,'After',location)
T2 = addvars(___,'NewVariableNames',newNames)

説明

T2 = addvars(T1,var1,...,varN)var1,…,varN で指定された変数を T1 の最後の変数の右側に追加します。入力引数 var1,…,varN は任意の型の配列、table および timetable を含むことができます。すべての入力引数は、同じ行数でなければなりません。

T2 = addvars(T1,var1,...,varN,'Before',location) は、location で示された table 変数の左側に変数を挿入します (図を参照)。location を変数名、数値インデックスまたは論理インデックスとして指定できます。

T2 = addvars(T1,var1,...,varN,'After',location)location で示された table 変数の右側に変数を挿入します。

T2 = addvars(___,'NewVariableNames',newNames)newNames で指定された名前を使用して、T2 内に追加される変数の名前を変更します。newNames の名前の数は、追加される変数の数と同じでなければなりません。この構文では、前述の構文の入力引数のいずれかを使用できます。

すべて折りたたむ

テーブルを作成します。次に、ワークスペースから table に変数を追加します。

patients.mat ファイルから配列を読み込みます。患者の名前、年齢、身長、体重を含む table を作成します。次に、最初の 3 行を表示します。

load patients
T1 = table(LastName,Age,Height,Weight);
head(T1,3)
ans=3×4 table
     LastName     Age    Height    Weight
    __________    ___    ______    ______

    'Smith'       38       71       176  
    'Johnson'     43       69       163  
    'Williams'    38       64       131  

ワークスペース変数 Gender および Smoker を table に追加します。

T2 = addvars(T1,Gender,Smoker);
head(T2,3)
ans=3×6 table
     LastName     Age    Height    Weight     Gender     Smoker
    __________    ___    ______    ______    ________    ______

    'Smith'       38       71       176      'Male'      true  
    'Johnson'     43       69       163      'Male'      false 
    'Williams'    38       64       131      'Female'    false 

テーブルを作成します。次に、table 内の指定された位置の前後に変数を挿入します。

patients.mat ファイルから配列を読み込みます。患者の名前と性別を含む table を作成します。次に、最初の 3 行を表示します。

load patients
T1 = table(LastName,Gender);
head(T1,3)
ans=3×2 table
     LastName      Gender 
    __________    ________

    'Smith'       'Male'  
    'Johnson'     'Male'  
    'Williams'    'Female'

ワークスペース変数 Age を table 変数 Gender の前に挿入します。table 変数を名前で参照するには、その名前を文字ベクトルとして指定します。

T2 = addvars(T1,Age,'Before','Gender');
head(T2,3)
ans=3×3 table
     LastName     Age     Gender 
    __________    ___    ________

    'Smith'       38     'Male'  
    'Johnson'     43     'Male'  
    'Williams'    38     'Female'

Age の後にさらに変数を挿入します。Age は T2 内の table 変数であるため、その名前を文字ベクトルとして指定します。

T3 = addvars(T2,Height,Weight,'After','Age');
head(T3,3)
ans=3×5 table
     LastName     Age    Height    Weight     Gender 
    __________    ___    ______    ______    ________

    'Smith'       38       71       176      'Male'  
    'Johnson'     43       69       163      'Male'  
    'Williams'    38       64       131      'Female'

最初の table 変数の後に Smoker を挿入します。名前の代わりに table 内の位置で変数を指定できます。

T4 = addvars(T3,Smoker,'After',1);
head(T4,3)
ans=3×6 table
     LastName     Smoker    Age    Height    Weight     Gender 
    __________    ______    ___    ______    ______    ________

    'Smith'       true      38       71       176      'Male'  
    'Johnson'     false     43       69       163      'Male'  
    'Williams'    false     38       64       131      'Female'

テーブルを作成します。table に変数を追加して新しい名前を付けます。

まず、ワークスペース変数から table を作成します。

load patients
T1 = table(LastName,Age,Gender,Smoker);
head(T1,3)
ans=3×4 table
     LastName     Age     Gender     Smoker
    __________    ___    ________    ______

    'Smith'       38     'Male'      true  
    'Johnson'     43     'Male'      false 
    'Williams'    38     'Female'    false 

DiastolicSystolic を組み合わせて 2 列の行列にします。新しい table 変数に BloodPressure という名前を付けます。

T2 = addvars(T1,[Diastolic Systolic],'NewVariableNames','BloodPressure');
head(T2,3)
ans=3×5 table
     LastName     Age     Gender     Smoker    BloodPressure
    __________    ___    ________    ______    _____________

    'Smith'       38     'Male'      true        93    124  
    'Johnson'     43     'Male'      false       77    109  
    'Williams'    38     'Female'    false       83    125  

新しい table 変数として HeightWeight を追加します。それらの名前を InchesPounds に変更します。

T3 = addvars(T2,Height,Weight,'Before','Smoker','NewVariableNames',{'Inches','Pounds'});
head(T3,3)
ans=3×7 table
     LastName     Age     Gender     Inches    Pounds    Smoker    BloodPressure
    __________    ___    ________    ______    ______    ______    _____________

    'Smith'       38     'Male'        71       176      true        93    124  
    'Johnson'     43     'Male'        69       163      false       77    109  
    'Williams'    38     'Female'      64       131      false       83    125  

入力引数

すべて折りたたむ

入力 table。table または timetable として指定します。

出力 table に追加する変数。配列、table および timetable として指定します。var1,...,varN で指定される変数はすべて、入力 table T1 と同じ行数でなければなりません。

例: T2 = addvars(T1,A) はワークスペース変数 A を最後の table 変数の右側に挿入します。

例: T2 = addvars(T1,X,Y,Z) はワークスペース変数 XY および Z を挿入します。

追加する変数の挿入位置。文字ベクトル、string スカラー、整数または logical 配列として指定します。

  • location が文字ベクトルまたは string スカラーである場合、これは入力 table T1 内の変数名です。

  • location が整数 n の場合、これは T1 内の n 番目の変数を指定します。

  • location が logical 配列で、その n 番目の要素が 1 (true) である場合、これは T1 内の n 番目の変数を指定します。location のその他の要素はすべて 0 (false) でなければなりません。

例: T2 = addvars(T1,Latitude,'Before','Longitude') はワークスペース変数 LatitudeLongitude という名前の table 変数の左側に挿入します。

例: T2 = addvars(T1,Y,Z,'After','X') はワークスペース変数 YZX という名前の table 変数の右側に挿入します。

追加する変数の名前。文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。

例: T2 = addvars(T1,lat,lon,'NewVariableNames',{'Latitude','Longitude'}) はワークスペース変数 latlon を挿入し、対応する table 変数に 'Latitude''Longitude' という名前を付けます。

R2018a で導入