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 thename1
vector.- val2
Specifies how the
name2
matrix or vector is copied into thename1
matrix."COL"
: Insert the new values at the column location specified byval1
(default)."row"
: Insert the new values at the row location specified byval1
.
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 andname2
must refer to a vector or another dense matrix.*MERGE
can also be used to add new rows to a vector that wascreated by the
*VEC
command. In this case,name1
andname2
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.