TMtx::ArcCos Method

TMtx Class

Overload List

#SignatureDescription
1TMtxVec *ArcCos();The inverse cosine.
2TMtxVec *ArcCos(int Index, int Len);Calculate the inverse cosine of calling object elements [Index]...[Index+Len-1] in-place.
3TMtxVec *ArcCos(TMtxVec *X);Calculate the inverse cosine of all X object elements.
4TMtxVec *ArcCos(TMtxVec *X, int XIndex, int Index, int Len);Calculate the inverse cosine of X object elements [XIndex]...[XIndex+Len-1].

Overload 1: TMtxVec *ArcCos();

The inverse cosine.

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,Math387::PI], in radians.

Examples
#include "Units.MtxVec.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::MtxVec;

void Example()
{
    TVec* a;
    CreateIt(a);
    a->SetIt(true, DewArray<double>{1,-0.5,0.11,0.9});
    a->ArcCos(); // Computes complex inverse cosine
    FreeIt(a);
}
#include "Math387.h"
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Vector a;
    a.SetIt(DewArray<double>{ 0.0, 0.5, 0.707106781186548, 0.866025403784439 });
    a.ArcCos();
    Vector expected;
    expected.SetIt(DewArray<double>{ 1.5707963267949, 1.0471975511966, 0.785398163397448, 0.523598775598299 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Vector.ArcCos: mismatch");
}
See Also: TMtx::Cos
Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler

Overload 2: TMtxVec *ArcCos(int Index, int Len);

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

#NameTypeDescription
1Indexint
2Lenint
Remarks:

An exception is raised if array borders are overrun.

Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler

Overload 3: TMtxVec *ArcCos(TMtxVec *X);

Calculate the inverse cosine of all X object elements.

#NameTypeDescription
1XTMtxVec *
Remarks:

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

Examples
#include "Math387.h"
#include "MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;

void Example()
{
    Vector a;
    Vector x;
    x.SetIt(DewArray<double>{ 0.0, 0.5, 0.707106781186548, 0.866025403784439 });
    a.ArcCos(x);
    Vector expected;
    expected.SetIt(DewArray<double>{ 1.5707963267949, 1.0471975511966, 0.785398163397448, 0.523598775598299 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Vector.ArcCos: mismatch");
}
Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler

Overload 4: TMtxVec *ArcCos(TMtxVec *X, int XIndex, int Index, int Len);

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

#NameTypeDescription
1XTMtxVec *
2XIndexint
3Indexint
4Lenint
Remarks:

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

Declared in Dew::Math::TMtxVec · Dew.Math/AbstractMtxVec.h · Cross-compiler