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 = 1×3 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 = 2×3 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. Si los nombres de filas están presentes en las entradas de tabla, deben ser idénticos, pero pueden estar en un orden diferente. horzcat realiza la concatenación haciendo coincidir los nombres de filas, cuando están presentes, o las posiciones de tabla si los nombres de filas no están presentes. Para entradas de tabla, horzcat también concatena valores de propiedades relacionados con las variables de la tabla. 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.

• Todas las entradas de horario deben tener nombres de variables únicos. Las horas de las filas de cada horario deben ser idénticas, pero pueden estar en un orden diferente. horzcat realiza la concatenación haciendo coincidir las horas de la fila. Para entradas de horario, horzcat también concatena valores de propiedades relacionados con las variables del horario 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 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. Si los nombres de filas están presentes en las entradas de tabla, deben ser idénticos, pero pueden estar en un orden diferente. horzcat realiza la concatenación haciendo coincidir los nombres de filas, cuando están presentes, o las posiciones de tabla si los nombres de filas no están presentes. Para entradas de tabla, horzcat también concatena valores de propiedades relacionados con las variables de la tabla. 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.

• Todas las entradas de horario deben tener nombres de variables únicos. Las horas de las filas de cada horario deben ser idénticas, pero pueden estar en un orden diferente. horzcat realiza la concatenación haciendo coincidir las horas de la fila. Para entradas de horario, horzcat también concatena valores de propiedades relacionados con las variables del horario 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.

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

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.

La función horzcat es compatible con arreglos altos con las siguientes 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 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 horzcat 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

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