Matrix.ArcCot Method

Overload List

#SignatureDescription
1function ArcCot: TMtxVec;Inverse cotangens.
└ indexed: function ArcCot(Index: Integer; Len: Integer): TMtxVec;
2function ArcCot(const X: TMtxVec): TMtxVec;Calculate the inverse cotangens of all X object elements and store the results in the calling object.
└ indexed: function ArcCot(const X: TMtxVec; XIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Overload 1: function ArcCot: TMtxVec;

Inverse cotangens.

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

Remarks:

Calculate the inverse cotangens for all calling object elements in-place. The return values are expressed in radians.

Examples
var A,B: Matrix;
begin
    A.SetIt(2,2,True,[1,0, 2,0
        2,0  4,1]);  // 2x2, complex matrix
    B.ArcCot(A); //or
    B := ArcCot(A);
end;
var
    a, expected: Matrix;
begin
    a := [[1.0, 1.5], [2.0, 3.0]];
    a.ArcCot;
    expected := [[0.785398163397448, 0.588002603547568], [0.463647609000806, 0.321750554396642]];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Matrix.ArcCot: mismatch');
end;
See Also: Matrix.Cot, Matrix.ArcTan

Indexed: function ArcCot(Index: Integer; Len: Integer): TMtxVec;

Calculate the inverse cotangens of calling object elements [Index]...[Index+Len-1] in-place.

#NameTypeDescription
1IndexIntegerstart index
2LenIntegerelement count

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

Remarks:

An exception is raised if array borders are overrun.

Overload 2: function ArcCot(const X: TMtxVec): TMtxVec;

Calculate the inverse cotangens of all X object elements and store the results in the calling object.

#NameTypeDescription
1XTMtxVec

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

Remarks:

Size and Matrix.Complex properties of calling object are adjusted automatically.

Examples
var
    a, x, expected: Matrix;
begin
    x := [[1.0, 1.5], [2.0, 3.0]];
    a.ArcCot(x);
    expected := [[0.785398163397448, 0.588002603547568], [0.463647609000806, 0.321750554396642]];
    if not a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute) then
        raise Exception.Create('Matrix.ArcCot: mismatch');
end;

Indexed: function ArcCot(const X: TMtxVec; XIndex: Integer; Index: Integer; Len: Integer): TMtxVec;

Calculate the inverse cotangens of X object elements [XIndex]...[XIndex+Len-1]. The results are stored in calling object elements [Index]...[Index+Len-1].

#NameTypeDescription
1XTMtxVec
2XIndexIntegerX start index
3IndexIntegerstart index
4LenIntegerelement count

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

Remarks:

Size and Matrix.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.