Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

table2array

Convert table to homogeneous array

Syntax

Description

example

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

Examples

collapse all

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.

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

Create a table with nonnumeric data in the first variable.

T = table(categorical({'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.

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

collapse all

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

collapse all

Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

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.

Introduced in R2013b

Was this topic helpful?