La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

array2table

Convertir un arreglo homogéneo en una tabla

Sintaxis

T = array2table(A)

T = array2table(A,Name,Value)

Descripción

T = array2table(A) convierte el arreglo de m por n, A, en una tabla de m por n, T. Cada columna de A se convierte en una variable en 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 para T

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

Nombres de fila para T, especificados como el par separado por comas que consta de 'RowNames' y 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 debe ser igual al número de filas, size(A,1).

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

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

VariableNames — Nombres de variable para T

arreglo de celdas de vectores de caracteres | arreglo de cadenas

Nombres de variable para T, especificados como el par separado por comas que consta de 'VariableNames' y 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 debe ser igual al número de variables, size(A,2).

Los nombres de las variables pueden tener cualquier carácter Unicode, incluidos espacios y caracteres no ASCII.

DimensionNames — Nombres de dimensiones

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

Desde la versión 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.

Antes de la versión R2021a, solo se podían especificar nombres de dimensiones configurando la propiedad DimensionNames de la salida.

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