Vector::ArcTan Method

Overload List

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

Overload 1: TMtxVec *ArcTan() const;

Inverse tangens.

Remarks:

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

Examples
#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, 1.0, 2.0 });
    a.ArcTan();
    Vector expected;
    expected.SetIt(DewArray<double>{ 0.0, 0.463647609000806, 0.785398163397448, 1.10714871779409 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Vector.ArcTan: mismatch");
}
#include "MtxExpr.h"
#include "Units.MtxExpr.h"

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::MtxExpr;

void Example()
{
    Vector A, B;

    A.SetIt(true, DewArray<double>{1,0, 2,0,
        2,0, 4,1});  // 4 element complex vector
    B.ArcTan(A); // or
    B = ArcTan(A);  // or
    A = ArcTan(A);
}
See Also: Vector::Tan, Vector::ArcCot, Vector::ArcTan2
Declared in Dew::Math::Vector · Dew.Math/MtxExpr.h · Cross-compiler

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

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

#NameTypeDescription
1Indexint
2Lenint
Remarks:

An exception is raised if array borders are overrun.

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

using namespace Dew;
using namespace Dew::Math;
using namespace Dew::Math::Units::Math387;
using namespace Dew::Math::Units::MtxExpr;

void Example()
{
    Vector A, B;

    A = {Cplx(1, 0), Cplx(2, 0), Cplx(2, 0), Cplx(4, 1)}; // four complex values
    B.ArcTan(A); // or
    B = ArcTan(A); // or
    A = ArcTan(A);
}
Declared in Dew::Math::Vector · Dew.Math/MtxExpr.h · Cross-compiler

Overload 3: TMtxVec *ArcTan(TMtxVec *X) const;

Calculate the inverse tangens of all X object elements.

#NameTypeDescription
1XTMtxVec *
Remarks:

Store the results in the calling object. Size and Vector::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, 1.0, 2.0 });
    a.ArcTan(x);
    Vector expected;
    expected.SetIt(DewArray<double>{ 0.0, 0.463647609000806, 0.785398163397448, 1.10714871779409 });
    if (!a.IsEqual(expected, 1e-10, TCompare::cmpAbsolute))
        throw tException("Vector.ArcTan: mismatch");
}
Declared in Dew::Math::Vector · Dew.Math/MtxExpr.h · Cross-compiler

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

Calculate the inverse tangens 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 Vector::Complex properties of the calling object must be set explicitly. An exception is raised if array borders are overrun.

Declared in Dew::Math::Vector · Dew.Math/MtxExpr.h · Cross-compiler