Vector.Normalize Method

Overload List

#	Signature	Description
1	function Normalize(const SubOffset: TCplx; const DivFactor: TCplx): TMtxVec;	Normalize by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.
	└ indexed: function Normalize(const SubOffset: TCplx; const DivFactor: TCplx; Index: Integer; Len: Integer): TMtxVec;
2	function Normalize(const SubOffset: TCplx; const DivFactor: Double): TMtxVec;	Normalize object by subtracting a complex constant SubOffset from elements and dividing the result by real constant DivFactor.
	└ indexed: function Normalize(const SubOffset: TCplx; const DivFactor: Double; Index: Integer; Len: Integer): TMtxVec;
3	function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: TCplx): TMtxVec;	Normalize Vec object by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.
	└ indexed: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: TCplx; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
4	function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: Double): TMtxVec;	Normalize Vec object by subtracting a complex constant SubOffset from Vec elements and dividing the result by real constant DivFactor.
	└ indexed: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
5	function Normalize(const Vec: TMtxVec; SubOffset: Double; DivFactor: Double): TMtxVec;	Normalize object.
	└ indexed: function Normalize(const Vec: TMtxVec; SubOffset: Double; DivFactor: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
6	function Normalize(const SubOffset: Double; const DivFactor: Double): TMtxVec;	Normalize data.
	└ indexed: function Normalize(const SubOffset: Double; const DivFactor: Double; Index: Integer; Len: Integer): TMtxVec;

Overload 1: function Normalize(const SubOffset: TCplx; const DivFactor: TCplx): TMtxVec;

Normalize by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

#	Name	Type	Description
1	SubOffset	TCplx
2	DivFactor	TCplx

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

Remarks:

Size and Vector.Complex property of calling object are adjusted automatically. An exception is raised, if object is complex.

Indexed: function Normalize(const SubOffset: TCplx; const DivFactor: TCplx; Index: Integer; Len: Integer): TMtxVec;

Normalize objects complex values [Index]..[Index+Len-1] by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

#	Name	Type	Description
1	SubOffset	TCplx
2	DivFactor	TCplx
3	Index	Integer	start index
4	Len	Integer	element count

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

Remarks:

An exception is raised, if object is not complex or array borders are overrun/underrun.

Overload 2: function Normalize(const SubOffset: TCplx; const DivFactor: Double): TMtxVec;

Normalize object by subtracting a complex constant SubOffset from elements and dividing the result by real constant DivFactor.

#	Name	Type	Description
1	SubOffset	TCplx
2	DivFactor	Double

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

Remarks:

An exception is raised, if object is not complex.

Indexed: function Normalize(const SubOffset: TCplx; const DivFactor: Double; Index: Integer; Len: Integer): TMtxVec;

Normalize objects complex values [Index]..[Index+Len-1] by subtracting a complex constant SubOffset from elements and dividing the result by real constant DivFactor.

#	Name	Type	Description
1	SubOffset	TCplx
2	DivFactor	Double
3	Index	Integer	start index
4	Len	Integer	element count

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

Remarks:

Store the results in calling vector complex values [Index]..[Index+Len-1]. An exception is raised, if the calling object is not complex or array borders are overrun/underrun.

Overload 3: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: TCplx): TMtxVec;

Normalize Vec object by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

#	Name	Type	Description
1	Vec	TMtxVec
2	SubOffset	TCplx	scalar
3	DivFactor	TCplx	scalar

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

Remarks:

Size and Vector.Complex property of calling object are adjusted automatically. An exception is raised if Vec is complex.

Indexed: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: TCplx; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Normalize Vec object complex values [VecIndex]..[VecIndex+Len-1] by subtracting a complex constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

#	Name	Type	Description
1	Vec	TMtxVec
2	SubOffset	TCplx	scalar
3	DivFactor	TCplx	scalar
4	VecIndex	Integer
5	Index	Integer	start index
6	Len	Integer	element count

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

Remarks:

Store the results in calling vector complex values [Index]..[Index+Len-1]. An exception is raised if Vec or calling object is not complex or array borders are overrun/underrun.

Overload 4: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: Double): TMtxVec;

Normalize Vec object by subtracting a complex constant SubOffset from Vec elements and dividing the result by real constant DivFactor.

#	Name	Type	Description
1	Vec	TMtxVec
2	SubOffset	TCplx	scalar
3	DivFactor	Double	scalar

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

Remarks:

Size and Vector.Complex property of calling object are adjusted automatically. An exception is raised if Vec is complex.

Indexed: function Normalize(const Vec: TMtxVec; SubOffset: TCplx; DivFactor: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Normalize Vec object complex values [VecIndex]..[VecIndex+Len-1] by subtracting a complex constant SubOffset from Vec elements and dividing the result by real constant DivFactor.

#	Name	Type	Description
1	Vec	TMtxVec
2	SubOffset	TCplx	scalar
3	DivFactor	Double	scalar
4	VecIndex	Integer
5	Index	Integer	start index
6	Len	Integer	element count

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

Remarks:

Store the results in calling vector complex values [Index]..[Index+Len-1]. An exception is raised if Vec or calling object is not complex or array borders are overrun/underrun.

Overload 5: function Normalize(const Vec: TMtxVec; SubOffset: Double; DivFactor: Double): TMtxVec;

Normalize object.

#	Name	Type	Description
1	Vec	TMtxVec
2	SubOffset	Double	scalar
3	DivFactor	Double	scalar

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

Remarks:

Normalizes Vec object by subtracting a constant Offset from Vec elements and dividing the result by constant Factor:

\text{V}[k]=\frac{\text{Vec}[k]-\text{Offset}}{\text{Factor}}

The results are stored in calling object. Use this method if you want to do a multiply and add (scale and offset) operations in a single method call.

Examples

var a,b: Vector;
begin
    a.SetIt(False,[1,2,3,4]);
    b.Normalize(a,2,3);
end;

See Also: Vector.Offset, Vector.Scale

Indexed: function Normalize(const Vec: TMtxVec; SubOffset: Double; DivFactor: Double; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Normalize Vec object values [VecIndex]..[VecIndex+Len-1] by subtracting a real constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

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

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

Remarks:

Store the results in calling vector values [Index]..[Index+Len-1]. An exception is raised if Vec or calling object is complex or array borders are overrun/underrun.

Overload 6: function Normalize(const SubOffset: Double; const DivFactor: Double): TMtxVec;

Normalize data.

#	Name	Type	Description
1	SubOffset	Double
2	DivFactor	Double

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

Remarks:

Normalizes values in the calling object by subtracting a constant Offset from Elements and dividing the result by constant Factor:

\text{V}[k]=\frac{\text{Vec}[k]-\text{Offset}}{\text{Factor}}

The results are stored in calling object. Use this method if you want to do a multiply and add (scale and offset) operations in a single method call.

Examples

var a: TVec;
begin
    CreateIt(a);
    try
        a.SetIt(False,[1,2,3,4]);
        a.Normalize(2,3);
    finally
        FreeIt(a);
    end;
end;

See Also: TDenseMtxVec.Offset, Vector.Scale

Indexed: function Normalize(const SubOffset: Double; const DivFactor: Double; Index: Integer; Len: Integer): TMtxVec;

Normalize object values [Index]..[Index+Len-1] by subtracting a real constant SubOffset from Vec elements and dividing the result by complex constant DivFactor.

#	Name	Type	Description
1	SubOffset	Double
2	DivFactor	Double
3	Index	Integer	start index
4	Len	Integer	element count

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

Remarks:

Store the results in calling vector values [Index]..[Index+Len-1]. An exception is raised, if Vec or calling object is complex or array borders are overrun/underrun.