moper#
- Mapdl.moper(parr='', par1='', oper='', val1='', val2='', val3='', val4='', val5='', val6='', **kwargs)#
Performs matrix operations on array parameter matrices.
APDL Command:
*MOPER
- Parameters:
- parr
The name of the resulting array parameter matrix. See
*SET
for name restrictions.- par1
First array parameter matrix input to the operation. For
Oper = MAP
, this is anN
x 3 array of coordinate locations at which to interpolate.ParR
will then be anN(out)
xM
array containing the interpolated values.- oper
Matrix operations:
INVERT -
(*MOPER, ParR, Par1, INVERT)
Square matrix invert: Inverts then
xn
matrix inPar1
intoParR
. The matrix must be well conditioned.Warning: Non-independent or ill-conditioned equations can cause erroneous results. - For large matrices, use the APDL Math operation
*LSFACTOR
for efficiency (see APDL Math).MULT -
(*MOPER, ParR, Par1, MULT, Par2)
Matrix multiply: MultipliesPar1
byPar2
. The number of rows ofPar2
must equal the number of columns ofPar1
for the operation. IfPar2
is input with a number of rows greater than the number of columns ofPar1
, matrices are still multiplied. However, the operation only uses a number of rows ofPar2
equal to the number of columns ofPar1
.COVAR -
(*MOPER, ParR, Par1, COVAR, Par2)
Covariance: The measure of association between two columns of the input matrix (Par1
).Par1
, of size m runs (rows) byn
data (columns) is first processed to produce a row vector containing the mean of each column which is transposed to a column vector (Par2
) of n array elements. ThePar1
andPar2
operation then produces a resultingn
xn
matrix (ParR
) of covariances (with the variances as the diagonal terms).CORR -
(*MOPER, ParR, Par1, CORR, Par2)
Correlation: The correlation coefficient between two variables. The input matrix (Par1
), of size m runs (rows) by n data (columns), is first processed to produce a row vector containing the mean of each column which is then transposed to a column vector (Par2
) of n array elements. ThePar1
andPar2
operation then produces a resultingn
xn
matrix (ParR
) of correlation coefficients (with a value of 1.0 for the diagonal terms).SOLV -
(*MOPER, ParR, Par1, SOLV, Par2)
Solution of simultaneous equations: Solves the set ofn
equations of n terms of the forman_1 x_1 + an_2 x_2 + ... + an_n x_n = b_n
wherePar1
contains the matrix of a-coefficients,Par2
the vector(s) of b-values, andParR
the vector(s) of x-results.Par1
must be a square matrix. The equations must be linear, independent, and well conditioned.Warning: Non-independent or ill-conditioned equations can cause erroneous results. - For large matrices, use the APDL Math operation
*LSFACTOR
for efficiency (see APDL Math).SORT -
(*MOPER, ParR, Par1, SORT, Par2, n1, n2, n3)
Matrix sort: Sorts matrixPar1
according to sort vectorPar2
and places the result back inPar1
. Rows ofPar1
are moved to the corresponding positions indicated by the values ofPar2
.Par2
may be a column ofPar1
(in which case it will also be reordered). Alternatively, you may specify the column ofPar1
to sort using n1 (leavingPar2
blank). A secondary sort can be specified by columnn2
, and a third sort usingn3
.ParR
is the vector of initial row positions (the permutation vector). SortingPar1
according toParR
should reproduce the initial ordering.NNEAR -
(*MOPER, ParR, Par1, NNEAR, Toler)
Nearest Node: Quickly determine all the nodes within a specified tolerance of a given array.ParR
is a vector of the nearest selected nodes, or 0 if no nodes are nearer thanToler
.Par1
is then
x 3 array of coordinate locations.Toler
defaults to 1 and is limited to the maximum model size.ENEAR -
(*MOPER, ``ParR
,Par1
, ENEAR, Toler)`` Nearest Element: Quickly determine the elements with centroids that are within a specified tolerance of the points in a given array. -ParR
is a vector of the nearest selected elements, or 0 if no element centroids are nearer thanToler
.Par1
is then
x 3 array of coordinate locations.MAP -
(*MOPER, ParR, Par1, MAP, Par2, Par3, kDim, --, kOut, LIMIT)
Maps the results from one set of points to another. For example, you can map pressures from a CFD analysis onto your model for a structural analysis.Par1
is theNout
x 3 array of points that will be mapped to.Par2
is theNin
xM
array that containsM
values of data to be interpolated at each point and corresponds to theNin
x 3 points inPar3
. The resultingParR
is theNout
xM
array of mapped data points.For each point in the destination mesh, all possible triangles in the source mesh are searched to find the best triangle containing each point. It then does a linear interpolation inside this triangle. You should carefully specify your interpolation method and search criteria in order to provide faster and more accurate results (see
LIMIT
, below).kDim
is the interpolation criteria. IfkDim = 2 or 0
, two dimensional interpolation is applied (interpolate on a surface). IfkDim = 3
, three dimensional interpolation is applied (interpolate on a volume).kOut
specified how points outside of the domain are handled. IfkOut
= 0, use the value(s) of the nearest region point for points outside of the region. If`kOut`
= 1, set results outside of the region to zero.
LIMIT specifies the number of nearby points considered for interpolation. The default is 20, and the minimum is 5. Lower values will reduce processing time; however, some distorted or irregular sets of points will require a higher
LIMIT
value to encounter three nodes for triangulation.Output points are incorrect if they are not within the domain (area or volume) defined by the specified input points. Also, calculations for out-of-bound points require much more processing time than do points that are within bounds. Results mapping is available from the command line only.
INTP -
(*MOPER, ParR, Par1, INTP, Par2)
Finds the elements that contain each point in the array ofn
x 3 points inPar1
.Par2
will contain the set of element ID numbers andParR
will contain theirn
x 3 set of natural element coordinates (values between -1 and 1).Par1
must be in global Cartesian coordinates.SGET -
(*MOPER, ParR, Par1, SGET, Par2, Label, Comp)
Gets the nodal solution item corresponding to Label and Comp (see the PLNSOL command) and interpolates it to the given element locations.Par1
contains then
x 3 array of natural element coordinates (values between -1 and 1) of then
element ID numbers inPar2
.Par1
andPar2
are usually the output of the*MOPER,,,INTP
operation.ParR
contains then
interpolated results.Val1, Val2, ..., Val6
Additional input used in the operation. The meanings ofVal1
throughVal6
vary depending on the specified matrix operation. See the description of Oper for details.