TOpenCLMatrix.DotProdc Method

Overload List

#SignatureDescription
1TCplx DotProdc(TOpenCLMtxVec Vec)Scalar product of two complex arrays.
└ indexed: TCplx DotProdc(TOpenCLMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len)
2TCplx DotProdc(TOpenCLMtxVec Vec, Boolean ConjVec)Returns the scalar product between Vec and calling object complex elements.
└ indexed: TCplx DotProdc(TOpenCLMtxVec Vec, Boolean ConjVec, Int32 VecIndex, Int32 Index, Int32 Len)

Overload 1: TCplx DotProdc(TOpenCLMtxVec Vec)

Scalar product of two complex arrays.

#NameTypeDescription
1VecTOpenCLMtxVecsource TOpenCLVector or TOpenCLMatrix

Returns: TCplx (complex)

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 Dew.Math.TOpenCLBase.Complex property is false. The dot product is defined by the equation:

VV=k=0Length1V[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
using Dew.Math;
using Dew.Math.Units;

namespace Dew.Examples
{
    void Example()
    {
        clMtxVec.TOpenCLMatrix a,b;
        clMtxVec.CreateIt(out a, out b);
        try
        {
            a.Size(2,2, TclFloatPrecision.clFloat, false);
            b.Size(2,2, TclFloatPrecision.clFloat, false);

            a.CopyFromArray(new double[] {1,2,3,4});
            b.CopyFromArray(new double[] {4,3,2,1});
            double prod = a.DotProdc(b); //= (1+2i)*(5+6i)+(3+4i)*(7+8i)
        }
        finally
        {
            clMtxVec.FreeIt(ref a,ref b);
        }
    }
}

Indexed: TCplx DotProdc(TOpenCLMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len)

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

#NameTypeDescription
1VecTOpenCLMtxVecsource TOpenCLVector or TOpenCLMatrix
2VecIndexInt32
3IndexInt32start index
4LenInt32element count

Returns: TCplx (complex)

Remarks:

An exception is raised if Vec and calling object Dew.Math.TOpenCLBase.Complex property is False. An exception is raised if array borders are overrun or underrun.

Overload 2: TCplx DotProdc(TOpenCLMtxVec Vec, Boolean ConjVec)

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

#NameTypeDescription
1VecTOpenCLMtxVecsource TOpenCLVector or TOpenCLMatrix
2ConjVecBoolean

Returns: TCplx (complex)

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 Dew.Math.TOpenCLBase.Complex property is False.

Indexed: TCplx DotProdc(TOpenCLMtxVec Vec, Boolean ConjVec, Int32 VecIndex, Int32 Index, Int32 Len)

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

#NameTypeDescription
1VecTOpenCLMtxVecsource TOpenCLVector or TOpenCLMatrix
2ConjVecBoolean
3VecIndexInt32
4IndexInt32start index
5LenInt32element count

Returns: TCplx (complex)

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 Dew.Math.TOpenCLBase.Complex property is False. An exception is raised if array borders are overrun or underrun.