vertcat

Concatenar arreglos verticalmente

Sintaxis

C = vertcat(A,B)

C = vertcat(A1,A2,…,An)

Descripción

C = vertcat(A,B) concatena B verticalmente al final de A cuando A y B tienen tamaños compatibles (las longitudes de las dimensiones coinciden con excepción de la primera dimensión).

C = vertcat(A1,A2,…,An) concatena A1, A2, ... , An verticalmente.

vertcat equivale a utilizar corchetes para concatenar o anexar arreglos verticalmente. Por ejemplo, [A; B] es lo mismo que vertcat(A,B) cuando A y B son arreglos compatibles.

Ejemplos

Dos matrices

Concatene dos matrices verticalmente.

Cree dos matrices y anexe verticalmente la segunda matriz a la primera usando notación de corchetes.

A = [1 2 3; 4 5 6]

A = 2×3

     1     2     3
     4     5     6

B = [7 8 9]

B = 1×3

     7     8     9

C = [A; B]

C = 3×3

     1     2     3
     4     5     6
     7     8     9

Ahora, anexe verticalmente la segunda matriz a la primera usando vertcat.

D = vertcat(A,B)

D = 3×3

     1     2     3
     4     5     6
     7     8     9

Dos tablas

Cree una tabla A con tres filas y cinco variables.

A = table([5;6;5],['M';'M';'M'],[45;41;40],[45;32;34],{'NY';'CA';'MA'},...
    'VariableNames',{'Age' 'Gender' 'Height' 'Weight' 'Birthplace'},...
    'RowNames',{'Thomas' 'Gordon' 'Percy'})

A=3×5 table
              Age    Gender    Height    Weight    Birthplace
              ___    ______    ______    ______    __________

    Thomas     5       M         45        45        {'NY'}  
    Gordon     6       M         41        32        {'CA'}  
    Percy      5       M         40        34        {'MA'}  

Cree una tabla B con las mismas variables que en A, pero no el mismo orden.

B = table(['F';'M';'F'],[6;6;5],{'AZ';'NH';'CO'},[31;42;33],[39;43;40],...
    'VariableNames',{'Gender' 'Age' 'Birthplace' 'Weight' 'Height'})

B=3×5 table
    Gender    Age    Birthplace    Weight    Height
    ______    ___    __________    ______    ______

      F        6       {'AZ'}        31        39  
      M        6       {'NH'}        42        43  
      F        5       {'CO'}        33        40  

Concatene verticalmente las tablas A y B. Las variables de C están en el mismo orden que las variables de A y los nombres de fila predeterminados se utilizan para las filas de B.

C = vertcat(A,B)

C=6×5 table
              Age    Gender    Height    Weight    Birthplace
              ___    ______    ______    ______    __________

    Thomas     5       M         45        45        {'NY'}  
    Gordon     6       M         41        32        {'CA'}  
    Percy      5       M         40        34        {'MA'}  
    Row4       6       F         39        31        {'AZ'}  
    Row5       6       M         43        42        {'NH'}  
    Row6       5       F         40        33        {'CO'}  

Fechas con diferentes tipos

Concatene un vector de caracteres de fecha, una fecha de cadena y una fecha/hora en una única columna de fechas. El resultado es un vector columna de fecha/hora.

chardate = '2016-03-24';
strdate = "2016-04-19";
t = datetime('2016-05-10','InputFormat','yyyy-MM-dd');
C = vertcat(chardate,strdate,t)

C = 3×1 datetime
   24-Mar-2016
   19-Apr-2016
   10-May-2016

Arreglo de cadenas

Concatene tres arreglos de cadenas en un único arreglo.

A1 = ["str1" "str2"];
A2 = ["str3" "str4"];
A3 = ["str5" "str6"];
C = vertcat(A1,A2,A3)

C = 3×2 string
    "str1"    "str2"
    "str3"    "str4"
    "str5"    "str6"

Matrices en un arreglo de celdas

Cree un arreglo de celdas que contenga dos matrices. Concatene verticalmente las matrices del arreglo de celdas en una matriz.

M1 = [1 2; 3 4];
M2 = [5 6; 7 8];
A1 = {M1,M2};
C = vertcat(A1{:})

C = 4×2

     1     2
     3     4
     5     6
     7     8

Argumentos de entrada

A — Primera entrada

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Primera entrada, especificada como escalar, vector, matriz, arreglo multidimensional, tabla u horario.

B — Segunda entrada

escalar | vector | matriz | arreglo multidimensional | tabla | horario

Segunda entrada, especificada como escalar, vector, matriz, arreglo multidimensional, tabla u horario.

• Los elementos de B se concatenan al final de la primera entrada en la primera dimensión. Los tamaños de los argumentos de entrada deben ser compatibles. Por ejemplo, si la primera entrada es una matriz de tamaño 3 por 2, B debe tener dos columnas.

• Todas las entradas de tabla deben tener nombres de filas únicos. Si algunas de las entradas de la tabla no tienen nombres de filas, vertcat rellena los nombres de filas predeterminados para la salida. Los nombres de variables de cada tabla deben ser idénticos, pero las variables pueden estar en un orden diferente. vertcat realiza la concatenación haciendo coincidir los nombres de variables. Para entradas de tabla, vertcat también concatena valores de propiedades RowNames. Otros valores de propiedades de la tabla de salida se asignan usando los primeros valores de propiedades no vacíos (o no predeterminados) de las entradas correspondientes.

• Las horas de las filas de las entradas de horarios no tienen que ser únicas. Los nombres de variables de cada horario deben ser idénticos, pero las variables pueden estar en un orden diferente. vertcat realiza la concatenación haciendo coincidir los nombres de variables. Para entradas de horario, vertcat también concatena valores de la propiedad RowTimes y eventos asociados a las entradas. Otros valores de propiedades del horario de salida se asignan usando los primeros valores de propiedades no vacíos (o no predeterminados) de las entradas correspondientes.

• Puede concatenar combinaciones válidas de diferentes tipos. Para obtener más información acerca de cómo concatenar arreglos de caracteres, arreglos lógicos y tipos numéricos, consulte Valid Combinations of Unlike Classes.

A1,A2,…,An — Lista de entradas

lista separada por comas

Lista de entradas, especificada como lista separada por comas de elementos que desea concatenar en el orden en el que se especifican.

• Las entradas deben tener tamaños compatibles. Por ejemplo, si A1 es un vector fila de longitud m, las entradas restantes deben tener m columnas cada una para concatenarse verticalmente.

• Todas las entradas de tabla deben tener nombres de filas únicos. Si algunas de las entradas de la tabla no tienen nombres de filas, vertcat rellena los nombres de filas predeterminados para la salida. Los nombres de variables de cada tabla deben ser idénticos, pero las variables pueden estar en un orden diferente. vertcat realiza la concatenación haciendo coincidir los nombres de variables. Para entradas de tabla, vertcat también concatena valores de propiedades RowNames. Otros valores de propiedades de la tabla de salida se asignan usando los primeros valores de propiedades no vacíos (o no predeterminados) de las entradas correspondientes.

• Las horas de las filas de las entradas de horarios no tienen que ser únicas. Los nombres de variables de cada horario deben ser idénticos, pero las variables pueden estar en un orden diferente. vertcat realiza la concatenación haciendo coincidir los nombres de variables. Para entradas de horario, vertcat también concatena valores de la propiedad RowTimes y eventos asociados a las entradas. Otros valores de propiedades del horario de salida se asignan usando los primeros valores de propiedades no vacíos (o no predeterminados) de las entradas correspondientes.

• Puede concatenar combinaciones válidas de diferentes tipos. Para obtener más información acerca de cómo concatenar arreglos de caracteres, arreglos lógicos y tipos numéricos, consulte Valid Combinations of Unlike Classes.

Algoritmos

Al concatenar un arreglo vacío en un arreglo no vacío, vertcat omite el arreglo vacío en la salida. Por ejemplo, vertcat([1; 2],[]) devuelve el vector columna [1; 2].

Si todos los argumentos de entrada están vacíos y tienen tamaños compatibles, vertcat devuelve un arreglo vacío cuyo tamaño es igual al tamaño de salida cuando las entradas no están vacías. Por ejemplo, vertcat(zeros(1,0),zeros(2,0)) devuelve un arreglo vacío de 3 por 0. Si los tamaños de entrada no son compatibles, vertcat devuelve un arreglo vacío de 0 por 0.

Capacidades ampliadas

Arreglos altos

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

La función vertcat es compatible con arreglos altos con las siguientes notas y limitaciones de uso:

• No admite la concatenación vertical de arreglos de caracteres.

• No admite la concatenación de arreglos categóricos ordinales.

• Cuando se concatenan dos arreglos altos, el resultado es un arreglo alto basado en un almacén de datos diferente al de los arreglos altos de entrada. Por lo tanto, si intenta combinar el resultado de la concatenación con uno de los arreglos altos de entrada, los arreglos son incompatibles. Por ejemplo, el siguiente comando genera un error, puesto que la tabla alta original T está basada en un almacén de datos y la salida de la operación de concatenación está basada en otro almacén de datos:

  T.Var3 = [T.Var1(1); T.Var2(2:end)]

  De forma alternativa, si solo concatena valores en memoria a un arreglo alto, el resultado de la concatenación se basa en el mismo almacén de datos. Por ejemplo, si reemplaza T.Var1(1) en el anterior ejemplo con un escalar en memoria, el comando ejecuta:

  T.Var3 = [0; T.Var2(2:end)]

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

Entorno basado en subprocesos

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

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función vertcat es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• No se admiten matrices dispersas.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

horzcat | cat

Temas

• Crear, concatenar y ampliar matrices
• Valid Combinations of Unlike Classes
• Combine Categorical Arrays
• Concatenating Objects of Different Classes
• Métodos de concatenación