array2table

Convertir un arreglo homogéneo en una tabla

Sintaxis

T = array2table(A)

T = array2table(A,Name,Value)

Descripción

T = array2table(A) convierte un arreglo de m por n en una tabla de m por n. Cada columna de la entrada A se convierte en una variable en la salida T.

array2table utiliza el nombre del arreglo de entrada junto con el número de columna para nombrar las variables de la tabla. Si estos nombres no son identificadores válidos de MATLAB^®, array2table utiliza nombres con el formato 'Var1',...,'VarN', donde N es el número de columnas de A.

T = array2table(A,Name,Value) crea una tabla a partir de un arreglo, A, con opciones adicionales especificadas por uno o más argumentos de par Name,Value.

Por ejemplo, puede especificar nombres de filas o nombres de variables para incluirlos en la tabla.

Ejemplos

Convertir un arreglo numérico en una tabla

Cree un arreglo de datos numéricos.

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

A = 3×3

     1     4     7
     2     5     8
     3     6     9

Convierta el arreglo, A, en una tabla.

T = array2table(A)

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

    1     4     7 
    2     5     8 
    3     6     9 

La tabla tiene nombres de variable que añaden el número de columna al nombre del arreglo de entrada, A.

Convertir un arreglo en una tabla incluyendo los nombres de las variables

Cree un arreglo de datos numéricos.

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

Convierta el arreglo, A, en una tabla e incluya los nombres de las variables.

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   

Argumentos de entrada

A — Arreglo de entrada

matriz

Arreglo de entrada, especificado como matriz.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell
Soporte de números complejos: Sí

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: 'RowNames',{'row1','row2','row3'} utiliza los nombres de fila row1, row2 y row3 para la tabla T.

RowNames — Nombres de fila

{} (predeterminado) | arreglo de celdas de vectores de caracteres | arreglo de cadenas

Nombres de fila, especificados como un arreglo de celdas de vectores de caracteres o un arreglo de cadenas cuyos elementos no están vacíos y son distintos. El número de nombres de fila debe ser igual al número de filas del arreglo de entrada.

Los nombres de fila pueden tener cualquier carácter Unicode^®, incluidos espacios y caracteres no ASCII, excepto ':'.

Si especifica nombres de fila que tienen espacios en blanco iniciales o finales, array2table los elimina de los nombres de fila.

VariableNames — Nombres de variables

arreglo de celdas de vectores de caracteres | arreglo de cadenas

Nombres de variables, especificados como un arreglo de celdas de vectores de caracteres o un arreglo de cadenas cuyos elementos no están vacíos y son distintos. El número de nombres de variables debe ser igual al número de columnas del arreglo de entrada.

Los nombres de las variables pueden tener cualquier carácter Unicode, incluidos espacios y caracteres no ASCII. No obstante, un nombre de variable no puede coincidir con ningún nombre de dimensión de tabla ni con los nombres reservados 'Properties', 'RowNames', 'VariableNames' o ':'.

DimensionNames — Nombres de dimensiones

arreglo de celdas de dos elementos de vectores de caracteres | arreglo de cadenas de dos elementos

Desde R2021a

Nombres de dimensiones, especificados como un arreglo de celdas de dos elementos de vectores de caracteres o un arreglo de cadenas de dos elementos cuyos elementos no están vacíos y son distintos.

Los nombres de las dimensiones pueden tener cualquier carácter Unicode, incluidos espacios y caracteres no ASCII. No obstante, un nombre de dimensión no puede coincidir con ningún nombre de variable de tabla ni con los nombres reservados 'Properties', 'RowNames', 'VariableNames' o ':'.

Como alternativa, en todas las versiones se pueden especificar nombres de dimensiones estableciendo la propiedad DimensionNames de la tabla.

Argumentos de salida

T — Tabla de salida

tabla

Tabla de salida, devuelta como tabla. La tabla puede almacenar metadatos como descripciones, unidades de variables, nombres de variables y nombres de filas. Para obtener más información, consulte la sección Propiedades de table.

Sugerencias

• Si A es un arreglo de celdas, use cell2table(A) para crear una tabla a partir del contenido de las celdas de A. Cada variable de la tabla es numérica o un arreglo de celdas de vectores de caracteres. array2table(A) crea una tabla en la que cada variable es una columna de celdas.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

Esta función es compatible con arreglos altos, con las siguientes limitaciones:

No se admite el par nombre-valor 'RowNames'.

Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• En código generado, debe especificar el argumento de par nombre-valor 'VariableNames' cuando utilice esta función. Para obtener más información, consulte Code Generation for Tables (MATLAB Coder) y Table Limitations for Code Generation (MATLAB Coder).

Entorno basado en subprocesos
Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Historial de versiones

Introducido en R2013b

R2019b: Los nombres de las variables pueden contener espacios en blanco iniciales y finales

Los nombres de las variables de tablas y horarios con espacios en blanco iniciales o finales no se modifican.

En versiones anteriores, los espacios en blanco iniciales y finales se eliminaban de los nombres de las variables cuando se especificaban con el argumento de par nombre-valor 'VariableNames' o se asignaban a la propiedad VariableNames.

Para eliminar manualmente estos caracteres, utilice primero la función strtrim en los nombres y, a continuación, asígnelos como nombres de variables a la tabla u horario.

Consulte también

table2array | cell2table | struct2table | table | isvarname

Temas

• Acceder a datos en tablas