Main Content

horzcat

Concatenate DataMatrix objects horizontally

Syntax

DMObjNew = horzcat(DMObj1, DMObj2, ...)
DMObjNew = (DMObj1, DMObj2, ...)
DMObjNew = horzcat(DMObj1, B, ...)
DMObjNew = (DMObj1, B, ...)

Input Arguments

DMObj1, DMObj2DataMatrix objects, such as created by DataMatrix (object constructor).
BMATLAB® numeric or logical array.

Output Arguments

DMObjNewDataMatrix object created by horizontal concatenation.

Description

DMObjNew = horzcat(DMObj1, DMObj2, ...) or the equivalent DMObjNew = (DMObj1, DMObj2, ...) horizontally concatenates the DataMatrix objects DMObj1 and DMObj2 into DMObjNew, another DataMatrix object. DMObj1 and DMObj2 must have the same number of rows. The row names and the order of rows for DMObjNew are the same as DMObj1. The row names of DMObj2 and any other DataMatrix object input arguments are not preserved. The columns names for DMObjNew are the column names of DMObj1, DMObj2, and other DataMatrix object input arguments.

DMObjNew = horzcat(DMObj1, B, ...) or the equivalent DMObjNew = (DMObj1, B, ...) horizontally concatenates the DataMatrix object DMObj1 and a numeric or logical array B into DMObjNew, another DataMatrix object. DMObj1 and B must have the same number of rows. The row names for DMObjNew are the same as DMObj1. The row names of DMObj2 and any other DataMatrix object input arguments are not preserved. The column names for DMObjNew are the column names of DMObj1 and empty for the columns from B.

MATLAB calls DMObjNew = horzcat(X1, X2, X3, ...) for the syntax DMObjNew = [X1, X2, X3, ...] when any one of X1, X2, X3, etc. is a DataMatrix object.

Version History

Introduced in R2008b