clMatrix.NormL1 Method

Overload List

#	Signature	Description
1	Double NormL1	Calculate the L1-norm of the calling vector.
	└ indexed: Double NormL1(Int32 Index, Int32 Len)
2	Double NormL1(TOpenCLMtxVec Vec, Boolean RelativeError)	The L1-norm.
	└ indexed: Double NormL1(TOpenCLMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len, Boolean RelativeError)

Overload 1: Double NormL1

Calculate the L1-norm of the calling vector.

Returns: Double - L-1 norm, defined by the following equation: NormL1 = Sum(|a[i]|), 0 < i < Length-1

Indexed: Double NormL1(Int32 Index, Int32 Len)

Calculates the L1 norm from calling vector elements [Index]..[Index+Len-1].

#	Name	Type	Description
1	Index	Int32	start index
2	Len	Int32	element count

Returns: Double

Overload 2: Double NormL1(TOpenCLMtxVec Vec, Boolean RelativeError)

The L1-norm.

#	Name	Type	Description
1	Vec	TOpenCLMtxVec	source TOpenCLVector or TOpenCLMatrix
2	RelativeError	Boolean

Returns: Double - L-1 norm, defined by: ||V-Vec||, where V is calling vector.

Remarks:

If the NormL1 is called without any parameters, the NormL1 calculates the norm of calling vector. The L1 norm of ||V-Vec|| is defined by the formula:

\|\text{V} - \text{Vec}\| _{L1} = \sum _{k=0} ^{\text{Length}-1}|\text{V}[k]-\text{Vec}[k]|

If RelativeError is true then the computed norm is divided by the norm of V, and the function returns the "relative error":

\frac{\| \text{V} - \text{Vec}\|}{\|\text{V}\|}

Examples

using Dew.Math;
using Dew.Math.Units;

namespace Dew.Examples
{
    void Example()
    {
        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 c = a.NormL1(b,true);
        }
        finally
        {
            clMtxVec.FreeIt(ref a,ref b);
        }
    }
}

See Also: clMatrix.NormC, clMatrix.NormL2

Indexed: Double NormL1(TOpenCLMtxVec Vec, Int32 VecIndex, Int32 Index, Int32 Len, Boolean RelativeError)

Calculates the L1 norm ||V-Vec|| between Vec elements [VecIndex]..[VecIndex+Len-1] and calling vector elements [Index]..[Index+Len-1].

#	Name	Type	Description
1	Vec	TOpenCLMtxVec	source TOpenCLVector or TOpenCLMatrix
2	VecIndex	Int32
3	Index	Int32	start index
4	Len	Int32	element count
5	RelativeError	Boolean

Returns: Double