merge

Mapdl.merge(name1='', name2='', val1='', val2='', **kwargs)

Merges two dense matrices or vectors into one.

APDL Command: *MERGE

Parameters
  • name1 – Name of the matrix or vector to extend.

  • name2 – Name of the matrix or vector to be merged into name1.

  • val1

    If name1 refers to a dense matrix created by the *DMAT command then the column or row number indicating where the new values are to be inserted into the Name1 matrix.

    If name` refers to a vector created by *VEC then this is the row number indicating where the new values are to be inserted into the ``name1 vector.

  • val2

    Specifies how the name2 matrix or vector is copied into the name1 matrix.

    • "COL" : Insert the new values at the column location specified by val1 (default).

    • "row" : Insert the new values at the row location specified by val1.

Notes

merge can be used to add new columns or rows to a dense matrix that was created by the *DMAT command. In this case, name1 must be the name of the dense matrix and name2 must refer to a vector or another dense matrix.

*MERGE can also be used to add new rows to a vector that was

created by the *VEC command. In this case, name1 and name2 must both refer to vectors.

In all cases, the values of the original matrix or vector are retained, and the matrix or vector is resized to accommodate the additional rows or columns.