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

array2table

同種配列のテーブルへの変換

構文

T = array2table(A)

T = array2table(A,Name,Value)

説明

T = array2table(A) は、m 行 n 列の配列 A を m 行 n 列の table T に変換します。A の各列は T の 1 つの変数になります。

array2table は、テーブルの変数名の列番号に付加されている入力配列名を使用します。これらの名前が有効な MATLAB^® 識別子ではない場合、array2table は 'Var1',...,'VarN' 形式の名前を使用します。ここで、N は A の列数です。

T = array2table(A,Name,Value) は、1 つ以上の Name,Value ペアの引数で指定された追加のオプションを使用して、配列 A から table を作成します。

たとえば、テーブルに含める行名または変数名を指定できます。

例

数値配列のテーブルへの変換

数値データの配列を作成します。

A = [1 4 7; 2 5 8; 3 6 9]

A = 3×3

     1     4     7
     2     5     8
     3     6     9

配列 A を table に変換します。

T = array2table(A)

T=3×3 table
    A1    A2    A3
    __    __    __

    1     4     7 
    2     5     8 
    3     6     9 

table には、入力配列名 A に列番号が付加された変数名が含まれます。

配列の変数名を含むテーブルへの変換

数値データの配列を作成します。

A = [1 12 30.48; 2 24 60.96; 3 36 91.44]

A = 3×3

    1.0000   12.0000   30.4800
    2.0000   24.0000   60.9600
    3.0000   36.0000   91.4400

配列 A を table に変換し、変数名を含めます。

T = array2table(A,...
    'VariableNames',{'Feet','Inches','Centimeters'})

T=3×3 table
    Feet    Inches    Centimeters
    ____    ______    ___________
     1        12         30.48   
     2        24         60.96   
     3        36         91.44   

入力引数

A — 入力配列

行列

行列として指定される入力配列。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell
複素数のサポート: あり

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'RowNames',{'row1','row2','row3'} は、行名 row1、row2 および row3 を table T に使用します。

'RowNames' — T の行名

{} (既定値) | 文字ベクトルの cell 配列 | string 配列

T の行名。'RowNames' と、文字ベクトルの cell 配列、または string 配列 (それらの要素は空ではなく一意) で構成されるコンマ区切りのペアとして指定します。名前の数は行数 size(A,1) と等しくなければなりません。

'VariableNames' — T の変数名

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

T の変数名。'VariableNames' と、文字ベクトルの cell 配列、または string 配列 (それらの要素は空ではなく一意) で構成されるコンマ区切りのペアとして指定します。名前の数は変数の数 size(A,2) と等しくなければなりません。

さらに、変数名は有効な MATLAB 識別子でなければなりません。有効な MATLAB 識別子が変数名として使用できない場合、MATLAB は 'Var1' ... 'VarN' の形式で N 個の名前をもつ配列を使用します。ここで、N は変数の数です。関数 isvarname を使用して有効な MATLAB 変数名を確認できます。

出力引数

T — 出力テーブル

テーブル

テーブルとして返される出力テーブル。テーブルには、説明、変数単位、変数名、行名などのメタデータを保存できます。詳細については、table のプロパティの節を参照してください。

ヒント

• A が cell 配列の場合、cell2table(A) を使用して A 内のセルの内容からテーブルを作成します。テーブルの各変数は、数値または文字ベクトルの cell 配列です。array2table(A) は、各変数がセルの列であるテーブルを作成します。

拡張機能

tall 配列

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

この関数は tall 配列を制限付きでサポートしています。

'RowNames' の名前と値のペアはサポートされていません。

詳細については、tall 配列を参照してください。

参考

cell2table | isvarname | struct2table | table | table2array

トピック

• テーブル内のデータへのアクセス

R2013b で導入