clVector::DotProdc Method

Overload List

#SignatureDescription
1TCplx DotProdc(TOpenCLMtxVec *Vec) const;Scalar product of two complex arrays.
2TCplx DotProdc(TOpenCLMtxVec *Vec, int VecIndex, int Index, int Len) const;Returns the scalar product between Vec (complex) elements [VecIndex]..[VecIndex+Len-1] and calling object (complex) elements [Index]..[Index+Len-1].
3TCplx DotProdc(TOpenCLMtxVec *Vec, bool ConjVec) const;Returns the scalar product between Vec and calling object complex elements.
4TCplx DotProdc(TOpenCLMtxVec *Vec, bool ConjVec, int VecIndex, int Index, int Len) const;Returns the scalar product between Vec (complex) elements [VecIndex]..[VecIndex+Len-1] and calling object (complex) elements [Index]..[Index+Len-1].

Overload 1: TCplx DotProdc(TOpenCLMtxVec *Vec) const;

Scalar product of two complex arrays.

#NameTypeDescription
1VecTOpenCLMtxVec *
Remarks:

Calculates the dot product (scalar value) of the calling object and Vec object and returns a complex scalar value. An exception is raised if calling or Vec object clVector::Complex property is false. The dot product is defined by the equation:

V⋅V=∑k=0Length−1V[k]⋅V[k]\text{V}\cdot \text{V} = \sum _{k=0} ^{\text{Length}-1}\text{V}[k]\cdot \text{V}[k]

Both objects must be of equal size. If they are not, the method will return the dot product of the largest sub-array.

Examples
#include "Units.clMtxVec.h"
#include "clMtxVec.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::ClMtxVec;

void Example()
{
    TOpenCLVector *a, *b;
    CreateIt(a, b);
    a->CopyCplxFromArray(DewArray<double>{1,2,3,4});
    b->CopyCplxFromArray(DewArray<double>{5,6,7,8});
    TCplx prod = a->DotProdc(b); //= (1+2i)*(5+6i)+(3+4i)*(7+8i)
    FreeIt(a, b);
}
See Also: clVector::DotProd
Declared in Dew::Math::clVector · Dew.Math/clMtxExpr.h · Cross-compiler

Overload 2: TCplx DotProdc(TOpenCLMtxVec *Vec, int VecIndex, int Index, int Len) const;

Returns the scalar product between Vec (complex) elements [VecIndex]..[VecIndex+Len-1] and calling object (complex) elements [Index]..[Index+Len-1].

#NameTypeDescription
1VecTOpenCLMtxVec *
2VecIndexint
3Indexint
4Lenint
Remarks:

An exception is raised if Vec and calling object clVector::Complex property is False. An exception is raised if array borders are overrun or underrun.

Declared in Dew::Math::clVector · Dew.Math/clMtxExpr.h · Cross-compiler

Overload 3: TCplx DotProdc(TOpenCLMtxVec *Vec, bool ConjVec) const;

Returns the scalar product between Vec and calling object complex elements.

#NameTypeDescription
1VecTOpenCLMtxVec *
2ConjVecbool
Remarks:

If ConjVec is True, scalar product between calling object and conjugated Vec object elements is calculated. An exception is raised if Vec and calling object clVector::Complex property is False.

Declared in Dew::Math::clVector · Dew.Math/clMtxExpr.h · Cross-compiler

Overload 4: TCplx DotProdc(TOpenCLMtxVec *Vec, bool ConjVec, int VecIndex, int Index, int Len) const;

Returns the scalar product between Vec (complex) elements [VecIndex]..[VecIndex+Len-1] and calling object (complex) elements [Index]..[Index+Len-1].

#NameTypeDescription
1VecTOpenCLMtxVec *
2ConjVecbool
3VecIndexint
4Indexint
5Lenint
Remarks:

If ConjVec is True, scalar product between calling object and conjugated Vec object elements is calculated. An exception is raised if Vec and calling object clVector::Complex property is False. An exception is raised if array borders are overrun or underrun.

Declared in Dew::Math::clVector · Dew.Math/clMtxExpr.h · Cross-compiler