naginterfaces.library.specfun.jactheta_​real

naginterfaces.library.specfun.jactheta_real(k, x, q)[source]

jactheta_real returns the value of one of the Jacobian theta functions , , , or for a real argument and non-negative .

For full information please refer to the NAG Library document for s21cc

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/s/s21ccf.html

Parameters
kint

Denotes the function to be evaluated. Note that is equivalent to .

xfloat

The argument of the function.

qfloat

The argument of the function.

Returns
jtfloat

The value of one of the Jacobian theta functions , , , or for a real argument and non-negative .

Raises
NagValueError
(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

Notes

jactheta_real evaluates an approximation to the Jacobian theta functions , , , and given by

where and (the nome) are real with .

These functions are important in practice because every one of the Jacobian elliptic functions (see jacellip_complex()) can be expressed as the ratio of two Jacobian theta functions (see Whittaker and Watson (1990)). There is also a bewildering variety of notations used in the literature to define them. Some authors (e.g., Section 16.27 of Abramowitz and Stegun (1972)) define the argument in the trigonometric terms to be instead of . This can often lead to confusion, so great care must, therefore, be exercised when consulting the literature. Further details (including various relations and identities) can be found in the references.

jactheta_real is based on a truncated series approach. If differs from or by an integer when , it follows from the periodicity and symmetry properties of the functions that and . In a region for which the approximation is sufficiently accurate, is set equal to the first term () of the transformed series

and is set equal to the first two terms (i.e., ) of

where . Otherwise, the trigonometric series for and are used. For all values of , and are computed from the relations and .

References

Abramowitz, M and Stegun, I A, 1972, Handbook of Mathematical Functions, (3rd Edition), Dover Publications

Byrd, P F and Friedman, M D, 1971, Handbook of Elliptic Integrals for Engineers and Scientists, pp. 315–320, (2nd Edition), Springer–Verlag

Magnus, W, Oberhettinger, F and Soni, R P, 1966, Formulas and Theorems for the Special Functions of Mathematical Physics, 371–377, Springer–Verlag

Tølke, F, 1966, Praktische Funktionenlehre (Bd. II), 1–38, Springer–Verlag

Whittaker, E T and Watson, G N, 1990, A Course in Modern Analysis, (4th Edition), Cambridge University Press