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) especifica opciones utilizando uno o más argumentos nombre-valor, además del argumento de entrada de la sintaxis anterior. Por ejemplo, puede especificar nombres de variables estableciendo VariableNames en un arreglo de cadenas de nombres de variable.

Ejemplos

Convertir un arreglo numérico en una tabla

Cree un arreglo numérico.

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 en una tabla. La tabla tiene nombres de variable predeterminados creados a partir del nombre del arreglo de entrada, A, y los números de columna del arreglo de entrada.

T = array2table(A)

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

    1     4     7 
    2     5     8 
    3     6     9 

Especificar nombres de variables

Cree un arreglo numérico.

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 en una tabla con nombres de variable especificados.

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.

Ejemplo: RowNames=["row1" "row2" "row3"] especifica los nombres de fila row1, row2 y row3 para una tabla que tiene tres filas.

RowNames — Nombres de fila

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

Nombres de fila, especificados como un arreglo de cadenas o un arreglo de celdas de vectores de caracteres 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 el carácter de dos puntos, :.

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

VariableNames — Nombres de variables

arreglo de cadenas | arreglo de celdas de vectores de caracteres

Nombres de variables, especificados como un arreglo de cadenas o un arreglo de celdas de vectores de caracteres 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 el carácter de dos puntos, :.

DimensionNames — Nombres de dimensiones

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

Nombres de dimensiones, especificados como un arreglo de cadenas de dos elementos o un arreglo de celdas de dos elementos de vectores de caracteres 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 el carácter de dos puntos, :.

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:

El argumento de par nombre-valor RowNames no es compatible.

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 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).

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Consulte las notas y limitaciones de uso en la sección de generación de código C/C++. Las mismas notas y limitaciones de uso son aplicables a la generación de código GPU.

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 caracteres de espacio en blanco iniciales y finales

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

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

Para eliminar manualmente estos caracteres, utilice primero la función strip 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