SpecialFuncs::EllipComplete Function

Overload List

#SignatureDescription
1double EllipComplete(double m);Complete elliptic integral of the first kind, K(m).
2float EllipComplete(float m);
3double EllipComplete(double m, double Epsilon, double &e);Complete elliptic integrals of the first and second kind, K(m) and E(m).
4float EllipComplete(float m, float Epsilon, float &e);

Overload 1: double EllipComplete(double m);

Complete elliptic integral of the first kind, K(m).

#NameTypeDescription
1mdoubleDefines the integral parameter m = k^2, a real value on the closed interval [0,1].

Returns: the complete elliptic integral of the first kind K(m), evaluated at the parameter m. Parameter m must lie on the closed interval [0,1], otherwise an exception is raised.

Remarks:

Computes the complete elliptic integral of the first kind in the parameter convention m = k^2 (m is the modulus squared, not the
modulus k), evaluated by the arithmetic-geometric-mean (AGM) iteration:

K(m)=integral _0^(pi/2)dtheta/(sqrt(1-m sin^2theta))=pi/(2 AGM(1,sqrt(1-m))).

Domain: the parameter m must lie on the closed interval [0,1]. Boundary behavior: K(0)=\pi/2; at m=1 the integral diverges and the routine returns +INF. For m<0 or m>1 the argument is outside the domain and an exception is raised (it does not return NaN).

Declared in Dew::Math::Units::SpecialFuncs · Dew.Math/Units.SpecialFuncs.h · Cross-compiler

Overload 2: float EllipComplete(float m);

#NameTypeDescription
1mfloat
Declared in Dew::Math::Units::SpecialFuncs · Dew.Math/Units.SpecialFuncs.h · Cross-compiler

Overload 3: double EllipComplete(double m, double Epsilon, double &e);

Complete elliptic integrals of the first and second kind, K(m) and E(m).

#NameTypeDescription
1mdoubleDefines the integral parameter m = k^2, a real value on the closed interval [0,1].
2EpsilondoubleDefines the accuracy for the AGM iteration used to evaluate both elliptic integrals.
3edouble &Returns the value of the complete elliptic integral of the second kind E(m), evaluated at the parameter m, to the accuracy Epsilon.

Returns: the complete elliptic integral of the first kind K(m), evaluated at the parameter m. Parameter m must lie on the closed interval [0,1], otherwise an exception is raised.

Remarks:

Returns the complete elliptic integral of the first kind K(m) and, through the out-parameter e, the complete elliptic integral of the second kind E(m), both in the parameter convention m = k^2, computed by a shared AGM iteration to accuracy Epsilon:

K(m)=integral _0^(pi/2)dtheta/(sqrt(1-m sin^2theta)), E(m)=integral _0^(pi/2)sqrt(1-m sin^2theta) dtheta.

Domain: m on the closed interval [0,1]. Boundary behavior: K(0)=E(0)=\pi/2; at m=1, K=+INF and E=1. For m<0 or m>1 an exception is raised (no NaN return).

See Also: SpecialFuncs::EllipJacoby
Declared in Dew::Math::Units::SpecialFuncs · Dew.Math/Units.SpecialFuncs.h · Cross-compiler

Overload 4: float EllipComplete(float m, float Epsilon, float &e);

#NameTypeDescription
1mfloat
2Epsilonfloat
3efloat &
Declared in Dew::Math::Units::SpecialFuncs · Dew.Math/Units.SpecialFuncs.h · Cross-compiler