addvars

変数を table または timetable に追加

構文

T2 = addvars(T1,var1,...,varN)

T2 = addvars(T1,var1,...,varN,After=location)

T2 = addvars(T1,var1,...,varN,Before=location)

T2 = addvars(___,NewVariableNames=newNames)

説明

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

たとえば、T1 の最後の変数の後に A という名前の列ベクトルを追加するには、T2 = addvars(T1,A) を使用します。

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

たとえば、table 変数 var2 の後に A という名前の列ベクトルを挿入するには、T2 = addvars(T1,A,After="var2") を使用します。

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

たとえば、table 変数 var3 の前に A という名前の列ベクトルを挿入するには、T2 = addvars(T1,A,Before="var3") を使用します。

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

例

変数の追加

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

patients.mat ファイルから配列を読み込みます。患者の年齢、身長、体重を含む table を作成します。

load patients
T1 = table(Age,Height,Weight)

T1=100×3 table
    Age    Height    Weight
    ___    ______    ______

    38       71       176  
    43       69       163  
    38       64       131  
    40       67       133  
    49       64       119  
    46       68       142  
    33       64       142  
    40       68       180  
    28       68       183  
    31       66       132  
    45       68       128  
    42       66       137  
    25       71       174  
    39       72       202  
    36       65       129  
    48       71       181  
      ⋮

ワークスペース変数 Smoker および LastName を table に追加します。LastName は、追加する前に string 配列に変換します。

LastName = string(LastName);
T2 = addvars(T1,Smoker,LastName)

T2=100×5 table
    Age    Height    Weight    Smoker     LastName 
    ___    ______    ______    ______    __________

    38       71       176      true      "Smith"   
    43       69       163      false     "Johnson" 
    38       64       131      false     "Williams"
    40       67       133      false     "Jones"   
    49       64       119      false     "Brown"   
    46       68       142      false     "Davis"   
    33       64       142      true      "Miller"  
    40       68       180      false     "Wilson"  
    28       68       183      false     "Moore"   
    31       66       132      false     "Taylor"  
    45       68       128      false     "Anderson"
    42       66       137      false     "Thomas"  
    25       71       174      false     "Jackson" 
    39       72       202      true      "White"   
    36       65       129      false     "Harris"  
    48       71       181      true      "Martin"  
      ⋮

指定された位置に変数を挿入

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

patients.mat ファイルから配列を読み込みます。患者の名前と場所を含む table を作成します。

load patients
LastName = string(LastName);
Location = string(Location);
T1 = table(LastName,Location)

T1=100×2 table
     LastName              Location          
    __________    ___________________________

    "Smith"       "County General Hospital"  
    "Johnson"     "VA Hospital"              
    "Williams"    "St. Mary's Medical Center"
    "Jones"       "VA Hospital"              
    "Brown"       "County General Hospital"  
    "Davis"       "St. Mary's Medical Center"
    "Miller"      "VA Hospital"              
    "Wilson"      "VA Hospital"              
    "Moore"       "St. Mary's Medical Center"
    "Taylor"      "County General Hospital"  
    "Anderson"    "County General Hospital"  
    "Thomas"      "St. Mary's Medical Center"
    "Jackson"     "VA Hospital"              
    "White"       "VA Hospital"              
    "Harris"      "St. Mary's Medical Center"
    "Martin"      "VA Hospital"              
      ⋮

ワークスペース変数 Age を table 変数 Location の前に挿入します。table 変数を名前で参照するには、その名前を string として指定します。

T2 = addvars(T1,Age,Before="Location")

T2=100×3 table
     LastName     Age             Location          
    __________    ___    ___________________________

    "Smith"       38     "County General Hospital"  
    "Johnson"     43     "VA Hospital"              
    "Williams"    38     "St. Mary's Medical Center"
    "Jones"       40     "VA Hospital"              
    "Brown"       49     "County General Hospital"  
    "Davis"       46     "St. Mary's Medical Center"
    "Miller"      33     "VA Hospital"              
    "Wilson"      40     "VA Hospital"              
    "Moore"       28     "St. Mary's Medical Center"
    "Taylor"      31     "County General Hospital"  
    "Anderson"    45     "County General Hospital"  
    "Thomas"      42     "St. Mary's Medical Center"
    "Jackson"     25     "VA Hospital"              
    "White"       39     "VA Hospital"              
    "Harris"      36     "St. Mary's Medical Center"
    "Martin"      48     "VA Hospital"              
      ⋮

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

T3 = addvars(T2,Height,Weight,After="Age")

T3=100×5 table
     LastName     Age    Height    Weight             Location          
    __________    ___    ______    ______    ___________________________

    "Smith"       38       71       176      "County General Hospital"  
    "Johnson"     43       69       163      "VA Hospital"              
    "Williams"    38       64       131      "St. Mary's Medical Center"
    "Jones"       40       67       133      "VA Hospital"              
    "Brown"       49       64       119      "County General Hospital"  
    "Davis"       46       68       142      "St. Mary's Medical Center"
    "Miller"      33       64       142      "VA Hospital"              
    "Wilson"      40       68       180      "VA Hospital"              
    "Moore"       28       68       183      "St. Mary's Medical Center"
    "Taylor"      31       66       132      "County General Hospital"  
    "Anderson"    45       68       128      "County General Hospital"  
    "Thomas"      42       66       137      "St. Mary's Medical Center"
    "Jackson"     25       71       174      "VA Hospital"              
    "White"       39       72       202      "VA Hospital"              
    "Harris"      36       65       129      "St. Mary's Medical Center"
    "Martin"      48       71       181      "VA Hospital"              
      ⋮

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

T4 = addvars(T3,Smoker,After=1)

T4=100×6 table
     LastName     Smoker    Age    Height    Weight             Location          
    __________    ______    ___    ______    ______    ___________________________

    "Smith"       true      38       71       176      "County General Hospital"  
    "Johnson"     false     43       69       163      "VA Hospital"              
    "Williams"    false     38       64       131      "St. Mary's Medical Center"
    "Jones"       false     40       67       133      "VA Hospital"              
    "Brown"       false     49       64       119      "County General Hospital"  
    "Davis"       false     46       68       142      "St. Mary's Medical Center"
    "Miller"      true      33       64       142      "VA Hospital"              
    "Wilson"      false     40       68       180      "VA Hospital"              
    "Moore"       false     28       68       183      "St. Mary's Medical Center"
    "Taylor"      false     31       66       132      "County General Hospital"  
    "Anderson"    false     45       68       128      "County General Hospital"  
    "Thomas"      false     42       66       137      "St. Mary's Medical Center"
    "Jackson"     false     25       71       174      "VA Hospital"              
    "White"       true      39       72       202      "VA Hospital"              
    "Harris"      false     36       65       129      "St. Mary's Medical Center"
    "Martin"      true      48       71       181      "VA Hospital"              
      ⋮

変数名の変更

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

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

load patients
LastName = string(LastName);
T1 = table(LastName,Age,Smoker)

T1=100×3 table
     LastName     Age    Smoker
    __________    ___    ______

    "Smith"       38     true  
    "Johnson"     43     false 
    "Williams"    38     false 
    "Jones"       40     false 
    "Brown"       49     false 
    "Davis"       46     false 
    "Miller"      33     true  
    "Wilson"      40     false 
    "Moore"       28     false 
    "Taylor"      31     false 
    "Anderson"    45     false 
    "Thomas"      42     false 
    "Jackson"     25     false 
    "White"       39     true  
    "Harris"      36     false 
    "Martin"      48     true  
      ⋮

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

T2 = addvars(T1,[Diastolic Systolic],NewVariableNames="BloodPressure")

T2=100×4 table
     LastName     Age    Smoker    BloodPressure
    __________    ___    ______    _____________

    "Smith"       38     true        93    124  
    "Johnson"     43     false       77    109  
    "Williams"    38     false       83    125  
    "Jones"       40     false       75    117  
    "Brown"       49     false       80    122  
    "Davis"       46     false       70    121  
    "Miller"      33     true        88    130  
    "Wilson"      40     false       82    115  
    "Moore"       28     false       78    115  
    "Taylor"      31     false       86    118  
    "Anderson"    45     false       77    114  
    "Thomas"      42     false       68    115  
    "Jackson"     25     false       74    127  
    "White"       39     true        95    130  
    "Harris"      36     false       79    114  
    "Martin"      48     true        92    130  
      ⋮

新しい table 変数として Height と Weight を追加します。それらの名前を Inches と Pounds に変更します。

T3 = addvars(T2,Height,Weight,Before="Smoker",NewVariableNames=["Inches" "Pounds"])

T3=100×6 table
     LastName     Age    Inches    Pounds    Smoker    BloodPressure
    __________    ___    ______    ______    ______    _____________

    "Smith"       38       71       176      true        93    124  
    "Johnson"     43       69       163      false       77    109  
    "Williams"    38       64       131      false       83    125  
    "Jones"       40       67       133      false       75    117  
    "Brown"       49       64       119      false       80    122  
    "Davis"       46       68       142      false       70    121  
    "Miller"      33       64       142      true        88    130  
    "Wilson"      40       68       180      false       82    115  
    "Moore"       28       68       183      false       78    115  
    "Taylor"      31       66       132      false       86    118  
    "Anderson"    45       68       128      false       77    114  
    "Thomas"      42       66       137      false       68    115  
    "Jackson"     25       71       174      false       74    127  
    "White"       39       72       202      true        95    130  
    "Harris"      36       65       129      false       79    114  
    "Martin"      48       71       181      true        92    130  
      ⋮

入力引数

T1 — 入力 table

table | timetable

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

var1,...,varN — 出力 table に追加する変数

配列、table および timetable

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

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

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

location — 追加する変数の挿入位置

string スカラー | 文字ベクトル | 整数 | logical 配列

追加する変数の挿入位置。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") はワークスペース変数 Latitude を Longitude という名前の table 変数の左側に挿入します。

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

newNames — 追加する変数の名前

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

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

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

出力引数

T2 — 追加した変数を含む出力 table

table | timetable

追加した変数を含む出力 table。table または timetable として返されます。

制限

• 名前と値の引数には、Name=Value 構文が推奨されます。一方、Name,Value 構文を使用する場合は、入力名 'Before'、'After' および 'NewVariableNames' には一重引用符を使用します。変数入力と混同しないように、これらの名前には二重引用符で囲んだ string スカラー ("Before" など) を使用しないでください。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

addvars 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

addvars 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

addvars 関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2018a で導入

参考

mergevars | movevars | removevars | splitvars | renamevars

トピック

• table 変数の追加、削除、再配列
• テーブル行の追加と削除
• table 内のデータへのアクセス
• table 変数の名前変更と説明
• table 内の乱雑な欠損データの整理