TSparseMtx.ArcCos Method

Overload List

#	Signature	Description
1	TMtxVec ArcCos	The inverse cosine.
	└ indexed: TMtxVec ArcCos(Int32 Index, Int32 Len)
2	TMtxVec ArcCos(TMtxVec X)	Calculate the inverse cosine of all X object elements.
	└ indexed: TMtxVec ArcCos(TMtxVec X, Int32 XIndex, Int32 Index, Int32 Len)

Overload 1: TMtxVec ArcCos

The inverse cosine.

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

Remarks:

Calculate the inverse cosine of all calling object elements in-place. Values must be between -1 and 1. The return values will be in the range [0,Dew.Math.Units.Math387.PI], in radians.

Examples

Matrix a = new Matrix();
a.SetIt(2, 2, false, new double[] { 0.0, 0.5, 0.707106781186548, 0.866025403784439 });
a.ArcCos();
Matrix expected = new Matrix();
expected.SetIt(2, 2, false, new double[] { 1.5707963267949, 1.0471975511966, 0.785398163397448, 0.523598775598299 });
if (!a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute))
    throw new Exception("Matrix.ArcCos: mismatch");

Matrix a;
Matrix b;
a.SetIt(1,2 true,new double[] {1,-0.5,0.11,0.9});
a.ArcCos;  // or
b = ArcCos(a); // or
a = ArcCos(a);

Indexed: TMtxVec ArcCos(Int32 Index, Int32 Len)

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

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

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

Remarks:

An exception is raised if array borders are overrun.

Overload 2: TMtxVec ArcCos(TMtxVec X)

Calculate the inverse cosine of all X object elements.

#	Name	Type	Description
1	X	TMtxVec	source TVec or TMtx

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

Remarks:

Store the results in the calling object. Size and Dew.Math.TMtxVec.Complex properties of calling object are adjusted automatically.

Examples

Matrix a = new Matrix();
Matrix x = new Matrix();
x.SetIt(2, 2, false, new double[] { 0.0, 0.5, 0.707106781186548, 0.866025403784439 });
a.ArcCos(x);
Matrix expected = new Matrix();
expected.SetIt(2, 2, false, new double[] { 1.5707963267949, 1.0471975511966, 0.785398163397448, 0.523598775598299 });
if (!a.IsEqual(expected, 1e-10, TCompare.cmpAbsolute))
    throw new Exception("Matrix.ArcCos: mismatch");

Indexed: TMtxVec ArcCos(TMtxVec X, Int32 XIndex, Int32 Index, Int32 Len)

Calculate the inverse cosine of X object elements [XIndex]...[XIndex+Len-1].

#	Name	Type	Description
1	X	TMtxVec	source TVec or TMtx
2	XIndex	Int32	X start index
3	Index	Int32	start index
4	Len	Int32	element count

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

Remarks:

The results are stored in calling object elements [Index]...[Index+Len-1]. Size and Dew.Math.TMtxVec.Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.