definitionNumerical methods

Jacobian elliptic functions

Doubly periodic functions built on the complete elliptic integral, and the third kind of analytic behaviour in this corpus.

Evidence status

Checked against 3 inspected sources

3 sources were retrieved, identified and read, and the claims below are tied to specific passages at the scope those passages state. Each source also records what it cannot establish.

Rely on this page for

The specific claims that carry a cited passage, at the scope that passage states.

Working definition

DLMF 22.2.4, 22.2.5 and 22.2.6 define sn, cn and dn as ratios of theta functions. Two quantities carry the modulus into those definitions and both are built from the complete elliptic integral of the first kind: the nome at 22.2.1 is the exponential of minus pi times the complementary complete integral over the complete integral, and the argument scaling at 22.2.3 divides z by twice the complete integral. The chapter records the analytic character directly. Each of the twelve functions is doubly periodic in z at fixed modulus, meromorphic in z, and carries simple poles and simple zeros, and for modulus between zero and one all of them are real when z is real.

Notation

sn, cn and dn, with the twelve functions named by pairs of lettersk for the modulus and q for the nomeK of k for the complete elliptic integral and K prime for its complement

Assumptions

  • The nome and the argument scaling are defined through the complete elliptic integral, so these functions inherit whatever conditions that integral carries.
  • Double periodicity is stated at fixed modulus; the modulus is a parameter rather than a second variable.
  • Reality for real argument is stated only for modulus in the closed interval from zero to one.

Invariants

  • sn, cn and dn as theta ratios, DLMF 22.2.4 to 22.2.6
  • The nome expressed through the complete elliptic integral, DLMF 22.2.1
  • Doubly periodic and meromorphic with simple poles and simple zeros, DLMF 22.2 stated in prose rather than as a numbered equation

Reproducible procedure

  • Compute the complete elliptic integral first, since both the nome at 22.2.1 and the scaling at 22.2.3 depend on it.
  • Check the modulus against the closed unit interval before relying on real values for real argument.
  • Reduce an argument by the periods before evaluating, since double periodicity means a large argument carries no extra information.

Error and boundary controls

  • The functions have simple poles, so accuracy degrades near them and no reduction of the argument avoids a pole that the argument sits on.
  • The nome at 22.2.1 involves a ratio of complete integrals inside an exponential, so an error in the modulus is amplified before the functions are evaluated at all.
  • The chapter defines the functions and their periodicity and makes no accuracy claim about any evaluation scheme.

What this does not establish

The chapter gives the definitions, the periods and the analytic character. It does not establish that any evaluation scheme is accurate near a pole, and periodicity is not a statement about numerical conditioning.

Explicit applications

0 cross-domain bridges

This foundational concept currently supports related concepts; a direct domain bridge is scheduled for a later registry version.

Authoritative references

  1. [1]DLMF Chapter 22: Jacobian Elliptic Functions · National Institute of Standards and Technology

    Establishes: Definitions of the Jacobian elliptic functions through theta functions, the nome and the argument scaling both expressed through the complete elliptic integral, and their analytic character as doubly periodic meromorphic functions with simple poles and simple zeros.

    Boundary: The chapter defines the functions and their periodicity. It makes no accuracy claim about any evaluation, and the reality of the functions for real argument is stated only for modulus between zero and one.

Direct answer

  • DLMF 22.2.4, 22.2.5 and 22.2.6 define sn, cn and dn as ratios of theta functions. Two quantities carry the modulus into those definitions and both are built from the complete elliptic integral of the first kind: the nome at 22.2.1 is the exponential of minus pi times the complementary complete integral over the complete integral, and the argument scaling at 22.2.3 divides z by twice the complete integral. The chapter records the analytic character directly. Each of the twelve functions is doubly periodic in z at fixed modulus, meromorphic in z, and carries simple poles and simple zeros, and for modulus between zero and one all of them are real when z is real.

Mechanism and method

  • Compute the complete elliptic integral first, since both the nome at 22.2.1 and the scaling at 22.2.3 depend on it.
  • Check the modulus against the closed unit interval before relying on real values for real argument.
  • Reduce an argument by the periods before evaluating, since double periodicity means a large argument carries no extra information.

What is measured

  • sn, cn and dn as theta ratios, DLMF 22.2.4 to 22.2.6
  • The nome expressed through the complete elliptic integral, DLMF 22.2.1
  • Doubly periodic and meromorphic with simple poles and simple zeros, DLMF 22.2 stated in prose rather than as a numbered equation

Limitations

  • The functions have simple poles, so accuracy degrades near them and no reduction of the argument avoids a pole that the argument sits on.
  • The nome at 22.2.1 involves a ratio of complete integrals inside an exponential, so an error in the modulus is amplified before the functions are evaluated at all.
  • The chapter defines the functions and their periodicity and makes no accuracy claim about any evaluation scheme.
  • The nome and the argument scaling are defined through the complete elliptic integral, so these functions inherit whatever conditions that integral carries.
  • Double periodicity is stated at fixed modulus; the modulus is a parameter rather than a second variable.
  • Reality for real argument is stated only for modulus in the closed interval from zero to one.

What this does not establish

  • The chapter gives the definitions, the periods and the analytic character. It does not establish that any evaluation scheme is accurate near a pole, and periodicity is not a statement about numerical conditioning.

Related records

Related mathematical concepts