ansys.mapdl.core.Mapdl.mult#

Mapdl.mult(m1='', t1='', m2='', t2='', m3='', **kwargs)#

Performs the matrix multiplication M3 = M1 (T1) *M2 (T2).

Mechanical APDL Command: *MULT

Parameters:
m1str

Name of matrix M1. Must have been previously specified by a dmat or smat command.

t1str

Transpose key. Set T1 = TRANS to use the non-conjugate transpose of M1. Set T1 = CTRANS to use the conjugate transpose of M1. CTRANS is only applicable when the M1 matrix is complex. If blank, transpose will not be used.

m2str

Name of matrix M2. Must have been previously specified by a dmat command.

t2str

Transpose key. Set T2 = TRANS to use the non-conjugate transpose of M2. Set T2 = CTRANS to use the conjugate transpose of M2. CTRANS is only applicable when the M2 matrix is complex. If blank, transpose will not be used.

m3str

Name of resulting matrix, M3. Must be specified.

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

Argument Descriptions

  • m1 : str - Name of matrix M1. Must have been previously specified by a dmat or smat command.

  • t1 : str - Transpose key. Set T1 = TRANS to use the non-conjugate transpose of M1. Set T1 = CTRANS to use the conjugate transpose of M1. CTRANS is only applicable when the M1 matrix is complex. If blank, transpose will not be used.

  • m2 : str - Name of matrix M2. Must have been previously specified by a dmat command.

  • t2 : str - Transpose key. Set T2 = TRANS to use the non-conjugate transpose of M2. Set T2 = CTRANS to use the conjugate transpose of M2. CTRANS is only applicable when the M2 matrix is complex. If blank, transpose will not be used.

  • m3 : str - Name of resulting matrix, M3. Must be specified.

The matrices must be dimensionally consistent such that the number of columns of M1 (or the transposed matrix, if requested) is equal to the number of rows of M2 (or the transposed matrix, if requested).

You cannot multiply two sparse matrices with this command (that is, M1 and M2 cannot both be sparse). The resulting matrix, M3, will always be a dense matrix, no matter what combination of input matrices is used (dense*sparse, sparse*dense, or dense*dense).