Matrix::MulElem Method

Matrix Struct

Overload List

#SignatureDescription
1TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, TMtxVec *Z) const;Compute X*Y*Z
2TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, const double Z) const;Compute X*Y*zScalar
3TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, const TCplx &Z) const;Compute X*Y*zScalar
4TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, TMtxVec *Z, int zIndex, int Index, int Len) const;Compute X*Y*Z on sub array
5TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, const double Z, int Index, int Len) const;Compute X*Y*zScalar on sub array
6TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, const TCplx &Z, int Index, int Len) const;Compute X*Y*zScalar on sub array
7TMtx *MulElem(TMtx *Mtx) const;Matrix array multiplication.
8TMtx *MulElem(TMtx *Mtx1, TMtx *Mtx2) const;Multiplies elements in Mtx1 matrix with the elements in Mtx2 matrix (array multiplication) and stores the results in calling matrix.
9TMtx *MulElem(TVec *Vec, TMtx *Mtx) const;
10TMtx *MulElem(TMtx *Mtx, TVec *Vec) const;
11TMtx *MulElem(TVec *Vec1, TVec *Vec2) const;

Overload 1: TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, TMtxVec *Z) const;

Compute X*Y*Z

#NameTypeDescription
1XTMtxVec *
2YTMtxVec *
3ZTMtxVec *
Remarks:

The following expression would also run at the same or higher speed, when passing X also for the Z parameter:

X^2*Y

Examples
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Matrix A, B, C;

    A = {{1, 2}, {2, 4}};
    B = {{1, 2}, {2, 4}};
    C.MulElem(A, B);
    // C becomes:
    // [1, 4,
    //  4,16]
}
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 2: TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, const double Z) const;

Compute X*Y*zScalar

#NameTypeDescription
1XTMtxVec *
2YTMtxVec *
3Zconst double
Remarks:

The following expression would also run at the same or higher speed, when passing X also for the Z parameter:

X^2*zScalar

Examples
#include "MtxExpr.h"
#include "Units.Math387.h"
#include "Units.MtxExpr.h"
#include "Units.MtxVec.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::Math387;
using namespace Dew::Math::Units::MtxExpr;
using namespace Dew::Math::Units::MtxVec;

void Example()
{
    Vector X, Y, Z, A1, A2, A3;

    X = {1, 2, 3, 4};
    Y = {2, 3, 4, 5};
    Z = {3, 4, 5, 6};
    A1 = X * Y * Z;
    A2 = MulElem(X, Y, Z);
    A3.Mul(X, Y, Z);
    if (!A2.IsEqual(A1))
        ERaise("Problem");
    if (!A3.IsEqual(A1))
        ERaise("Problem");
}
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 3: TMtxVec *MulElem(TMtxVec *X, TMtxVec *Y, const TCplx &Z) const;

Compute X*Y*zScalar

#NameTypeDescription
1XTMtxVec *
2YTMtxVec *
3Zconst TCplx &
Remarks:

The following expression would also run at the same or higher speed, when passing X also for the Z parameter:

X^2*zScalar

Examples
#include "MtxExpr.h"
#include "Units.Math387.h"
#include "Units.MtxExpr.h"
#include "Units.MtxVec.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::Math387;
using namespace Dew::Math::Units::MtxExpr;
using namespace Dew::Math::Units::MtxVec;

void Example()
{
    Vector X, Y, A1, A2, A3;
    double zScalar;

    zScalar = 2.0;
    X = {1, 2, 3, 4};
    Y = {2, 3, 4, 5};
    A1 = (X * Y) * zScalar;
    A2 = MulElem(X, Y, zScalar);
    A3.Mul(X, Y, zScalar);
    if (!A2.IsEqual(A1))
        ERaise("Problem");
    if (!A3.IsEqual(A1))
        ERaise("Problem");
}
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 4: TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, TMtxVec *Z, int zIndex, int Index, int Len) const;

Compute X*Y*Z on sub array

#NameTypeDescription
1XTMtxVec *
2XIndexint
3YTMtxVec *
4YIndexint
5ZTMtxVec *
6zIndexint
7Indexint
8Lenint
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 5: TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, const double Z, int Index, int Len) const;

Compute X*Y*zScalar on sub array

#NameTypeDescription
1XTMtxVec *
2XIndexint
3YTMtxVec *
4YIndexint
5Zconst double
6Indexint
7Lenint
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 6: TMtxVec *MulElem(TMtxVec *X, int XIndex, TMtxVec *Y, int YIndex, const TCplx &Z, int Index, int Len) const;

Compute X*Y*zScalar on sub array

#NameTypeDescription
1XTMtxVec *
2XIndexint
3YTMtxVec *
4YIndexint
5Zconst TCplx &
6Indexint
7Lenint
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 7: TMtx *MulElem(TMtx *Mtx) const;

Matrix array multiplication.

#NameTypeDescription
1MtxTMtx *
Remarks:

Multiplies elements in Mtx matrix with the elements in the calling matrix (array multiplication) and stores the results in calling matrix. The Matrix::Rows, Matrix::Cols and Matrix::Complex properties of both matrices must match, otherwise an exception is raised.

Examples
#include "Math387.h"
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Matrix a;
    a.SetIt(2, 2, false, DewArray<double>{ 1.0, 2.0, 3.0, 4.0 });
    Matrix b;
    b.SetIt(2, 2, false, DewArray<double>{ 5.0, 6.0, 7.0, 8.0 });
    a.MulElem(b);
    Matrix expected;
    expected.SetIt(2, 2, false, DewArray<double>{ 5.0, 12.0, 21.0, 32.0 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Matrix.MulElem: mismatch");
}
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Matrix A, B, C;

    A.SetIt(2, 2, false, DewArray<double>{1, 2, 2, 4});
    B.SetIt(2, 2, false, DewArray<double>{1, 2, 2, 4});
    C.MulElem(A, B);
    // C becomes:
    // [1, 4,
    //  4,16]
}
See Also: Matrix::InvElem
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 8: TMtx *MulElem(TMtx *Mtx1, TMtx *Mtx2) const;

Multiplies elements in Mtx1 matrix with the elements in Mtx2 matrix (array multiplication) and stores the results in calling matrix.

#NameTypeDescription
1Mtx1TMtx *
2Mtx2TMtx *
Remarks:

The Matrix::Rows, Matrix::Cols and Matrix::Complex properties of calling matrix are set implicitly to match those of Mtx1 and Mtx2 matrices. Mtx1 and Mtx2 Rows, Cols, and Complex properties must be the same, otherwise an exception is raised.

Examples
#include "Math387.h"
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Matrix a;
    Matrix x;
    x.SetIt(2, 2, false, DewArray<double>{ 1.0, 2.0, 3.0, 4.0 });
    Matrix y;
    y.SetIt(2, 2, false, DewArray<double>{ 5.0, 6.0, 7.0, 8.0 });
    a.MulElem(x, y);
    Matrix expected;
    expected.SetIt(2, 2, false, DewArray<double>{ 5.0, 12.0, 21.0, 32.0 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Matrix.MulElem: mismatch");
}
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 9: TMtx *MulElem(TVec *Vec, TMtx *Mtx) const;

#NameTypeDescription
1VecTVec *
2MtxTMtx *
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 10: TMtx *MulElem(TMtx *Mtx, TVec *Vec) const;

#NameTypeDescription
1MtxTMtx *
2VecTVec *
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler

Overload 11: TMtx *MulElem(TVec *Vec1, TVec *Vec2) const;

#NameTypeDescription
1Vec1TVec *
2Vec2TVec *
Declared in Dew::Math::Matrix · Dew.Math/MtxExpr.h · Cross-compiler