horzcat

Concatenar arreglos horizontalmente

Sintaxis

C = horzcat(A,B)

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

Descripción

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

C = horzcat(A1,A2,…,An) concatena A1, A2, … , An horizontalmente.

horzcat equivale a utilizar corchetes para concatenar o anexar arreglos horizontalmente. Por ejemplo, [A,B] y [A B] son iguales a horzcat(A,B) cuando A y B son arreglos compatibles.

Ejemplos

Dos matrices

Concatene dos matrices horizontalmente.

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

A = [1 2; 3 4]

A = 2×2

     1     2
     3     4

B = [4 5 6; 7 8 9]

B = 2×3

     4     5     6
     7     8     9

C = [A,B]

C = 2×5

     1     2     4     5     6
     3     4     7     8     9

Ahora, anexe horizontalmente la segunda matriz a la primera usando horzcat.

D = horzcat(A,B)

D = 2×5

     1     2     4     5     6
     3     4     7     8     9

Dos tablas

Cree una tabla A con tres filas y dos variables.

A = table([5;6;5],['M';'M';'M'],...
    'VariableNames',{'Age' 'Gender'},...
    'RowNames',{'Thomas' 'Gordon' 'Percy'})

A=3×2 table
              Age    Gender
              ___    ______

    Thomas     5       M   
    Gordon     6       M   
    Percy      5       M   

Cree una tabla B con tres filas y tres variables.

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

B=3×3 table
              Height    Weight    Birthplace
              ______    ______    __________

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

Concatene horizontalmente A y B. El orden de las filas de C coincide con el orden de A.

C = horzcat(A,B)

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

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

Fechas con diferentes tipos

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

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

C = 1x3 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 = horzcat(A1,A2,A3)

C = 2x3 string
    "str1"    "str3"    "str5"
    "str2"    "str4"    "str6"

Matrices en un arreglo de celdas

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

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

C = 2×5

     1     2     5     6     7
     3     4     8     9    10

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 segunda 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 tres filas.

• Todas las entradas de tabla deben tener nombres de variables únicos. Cuando están presentes, los nombres de las filas deben ser idénticos, pero no su orden.

• Todas las entradas de horarios deben tener los mismos tiempos de la fila y todas las columnas deben tener nombres distintos.

• Puede concatenar combinaciones válidas de diferentes tipos. Para obtener más información, 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 columna de longitud m, las entradas restantes deben tener m filas cada una para concatenarse horizontalmente.

• Todas las entradas de tabla deben tener nombres de variables únicos. Cuando están presentes, los nombres de las filas deben ser idénticos, pero no su orden.

• Todas las entradas de horarios deben tener los mismos tiempos de la fila y todas las columnas deben tener nombres distintos.

• Puede concatenar combinaciones válidas de diferentes tipos. Para obtener más información, consulte Valid Combinations of Unlike Classes.

Sugerencias

• Para construir texto concatenando horizontalmente cadenas, vectores de caracteres o arreglos de celdas de vectores de caracteres, utilice la función strcat.

• Para construir un único fragmento de texto delimitado a partir de un arreglo de celdas de vectores de caracteres o de un arreglo de cadenas, utilice la función strjoin.

Algoritmos

Para entradas de tabla, horzcat realiza la concatenación haciendo coincidir los nombres de filas, cuando están presentes, o las posiciones de tabla. horzcat asigna valores para las propiedades Description y UserData de la salida usando los primeros valores no vacíos de las correspondientes propiedades de la entrada.

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

Si todos los argumentos de entrada están vacíos y tienen tamaños compatibles, horzcat 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, horzcat(zeros(0,1),zeros(0,2)) devuelve un arreglo vacío de 0 por 3. Si los tamaños de entrada no son compatibles, horzcat 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.

Notas y limitaciones de uso:

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

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 un entorno basado en subprocesos.

Arreglos GPU

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

Esta función es totalmente compatible con los arreglos de GPU. 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

vertcat | cat | strcat | strjoin

Temas

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