Documentation Center

  • Trial Software
  • Product Updates

table2array

Convert table to homogenous array

Syntax

Description

example

A = table2array(T) converts the table, T, to a homogeneous array, A.

Examples

expand all

Convert Table of Numeric Data to Array

Create a table, T, consisting of numeric data.

T = table([1;2;3],[2 8; 4 10; 6 12],[3 12 21; 6 15 24; 9 18 27],...
    'VariableNames',{'One' 'Two' 'Three'})
T = 

    One         Two                   Three          
    ___    _____________    _________________________

    1      2           8    3          12          21
    2      4          10    6          15          24
    3      6          12    9          18          27

Convert table, T, to an array.

A = table2array(T)
A =

     1     2     8     3    12    21
     2     4    10     6    15    24
     3     6    12     9    18    27

A contains two columns from variable Two and three columns from variable Three.

Convert Numeric Subset of Table to Array

Define the numeric subset of a table to convert to an array.

Create a table with nonnumeric data in the first variable.

T = table(['M';'M';'F';'F';'F'],[38;43;38;40;49],...
    [71;69;64;67;64],[176;163;131;133;119],...
    'VariableNames',{'Gender' 'Age' 'Height' 'Weight'})
T = 

    Gender    Age    Height    Weight
    ______    ___    ______    ______

    M         38     71        176   
    M         43     69        163   
    F         38     64        131   
    F         40     67        133   
    F         49     64        119   

Convert T(:,2:4) to an array.

A = table2array(T(:,2:4))
A =

    38    71   176
    43    69   163
    38    64   131
    40    67   133
    49    64   119

A does not include data from the variable Gender.

Convert Table with Three-Dimensional Variables to Array

Create a table, T, with two rows and three variables where each variable has three dimensions.

T = table(ones(2,1,3),2*ones(2,2,3),3*ones(2,3,3),...
    'VariableNames',{'One' 'Two' 'Three'})
T = 

         One               Two              Three     
    ______________    ______________    ______________

    [1x1x3 double]    [1x2x3 double]    [1x3x3 double]
    [1x1x3 double]    [1x2x3 double]    [1x3x3 double]

The size of the table is 2-by-3.

Convert table T to an array.

A = table2array(T)
A(:,:,1) =

     1     2     2     3     3     3
     1     2     2     3     3     3


A(:,:,2) =

     1     2     2     3     3     3
     1     2     2     3     3     3


A(:,:,3) =

     1     2     2     3     3     3
     1     2     2     3     3     3

The size of A is 2-by-6-by-3.

Input Arguments

expand all

T — Input tabletable

Input table, specified as a table. All variables in T must have sizes and data types that are compatible for horizontal concatenation. Specifically, the size of all variable dimensions greater than 2 must match.

  • If T is an m-byn table with variables that each have one column, then each variable becomes one column in A, and A is an m-by-n array.

  • If T contains variables that consist of more than one column, those variables become multiple columns in A, and the size of A is greater than the size of T.

  • If T contains variables with more than two dimensions, the number of dimensions of A is the same as the number of variable dimensions.

More About

expand all

Tips

  • table2array horizontally concatenates the variables in T to create A. If the variables in T are cell arrays, table2array does not concatenate their contents, and A is a cell array, equivalent to table2cell(T). To create an array containing the contents of variables that are all cell arrays, use cell2mat(table2cell(T)).

  • table2array(T) is equivalent to T{:,:}.

Algorithms

If T contains variables with different data types that are compatible for horizontal concatenation, table2array creates a homogeneous array, A, of the dominant data type. For example, if T contains double and single numeric data, table2array(T) returns an array with data type single.

See Also

| | |

Was this topic helpful?