Vector.ThreshAbsGT Method

Overload List

#	Signature	Description
1	function ThreshAbsGT(const Src: TMtxVec; const Value: Double): TMtxVec;	Perform threshold operation on all Src object values.
	└ indexed: function ThreshAbsGT(const Vec: TMtxVec; const Value: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
2	function ThreshAbsGT(const Value: Double): TMtxVec;	Threshold top and bottom centered around zero.
	└ indexed: function ThreshAbsGT(const Value: Double; Index: Integer; Len: Integer): TMtxVec;

Overload 1: function ThreshAbsGT(const Src: TMtxVec; const Value: Double): TMtxVec;

Perform threshold operation on all Src object values.

#	Name	Type	Description
1	Src	TMtxVec
2	Value	Double

Result: stored in self (calling object), returns self for chaining

Remarks:

Store the results in calling object. Size and Vector.Complex properties of the calling object are adjusted automatically.

Indexed: function ThreshAbsGT(const Vec: TMtxVec; const Value: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Perform a threshold operation Vec elements [VecIndex]..[VecIndex+Len-1].

#	Name	Type	Description
1	Vec	TMtxVec
2	Value	Double
3	VecIndex	Integer
4	Index	Integer	start index
5	Len	Integer	element count

Result: stored in self (calling object), returns self for chaining

Remarks:

Store the results in the calling object elements [Index]..[Index+Len-1]. Size and Vector.Complex properties of the calling object must be set explicitly. An exception is raised if TMtxVecBase.ConditionCheck is true and array borders are overrun/underrun.

Overload 2: function ThreshAbsGT(const Value: Double): TMtxVec;

Threshold top and bottom centered around zero.

#	Name	Type	Description
1	Value	Double

Result: stored in self (calling object), returns self for chaining

Remarks:

Perform threshold operation on all calling object values. The Value parameter is an upper bound for threshold operation. All values bigger than Value will be replaced with Value and all values smaller than -Value will be replaced with -Value. The comparison checks if abs(Values[i]) > Value.

Examples

var
    a, expected: Vector;
begin
    a := [1.0, 5.0, 3.0, 7.0, 2.0];
    a.ThreshAbsGT(4.0);
    expected := [1.0, 4.0, 3.0, 4.0, 2.0];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Vector.ThreshAbsGT: mismatch');
end;

var a: TVec;
begin
    CreateIt(a);
    try
        a.SetIt(True,[2,-1,3,4]);
        a.ThreshAbsGT(0.2); // a = [0.2,-0.2,0.2,0.2]
    finally
        FreeIt(a);
    end;
end;

See Also: Vector.ThreshTop

Indexed: function ThreshAbsGT(const Value: Double; Index: Integer; Len: Integer): TMtxVec;

Perfrom the threshold operation on calling object values [Index]..[Index+Len-1].

#	Name	Type	Description
1	Value	Double
2	Index	Integer	start index
3	Len	Integer	element count

Result: stored in self (calling object), returns self for chaining

Remarks:

An exception is raised if array borders are overrun/underrun.