TSparseMtx.PhaseSpectrum Method

function PhaseSpectrum(const Vec: TMtxVec): TMtxVec;

The phase angles (spectrum) of object elements.

#	Name	Type	Description
1	Vec	TMtxVec	source TVec or TMtx

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

Remarks:

Calculates the phase angles (spectrum) of all Vec object elements. Phase values are returned in radians and are in the range -PI,PI. Size and TMtxVec.Complex properties of the calling object are set implicitly to match Vec object. The phase angles are calculated from the following equation:

\text{Phase}[k] = \arctan \frac{\Im (\text{Vec}[k])}{\Re (\text{Vec}[k])}

Examples

var a,b: Matrix;
begin
    a.SetIt(1,2,True,[1,2,3,4]);  // a = [1 + 2i, 3 - 4i]
    b.PhaseSpectrum(a);  // b = [arctan2(1,2), arctan2(3,-4)];
end;

Indexed: function PhaseSpectrum(const Vec: TMtxVec; VecIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Calculates the power spectrum from the Vec elements [VecIndex]..[VecIndex+Len-1].

#	Name	Type	Description
1	Vec	TMtxVec	source TVec or TMtx
2	VecIndex	Integer
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 object elements [Index]..[Index+Len-1]. An exception is raised if array borders are overrun/underrun.