gives the Jacobi elliptic function .


  • Mathematical function, suitable for both symbolic and numerical manipulation.
  • , where .
  • is a doubly periodic function in with periods and , where is the elliptic integral EllipticK.
  • JacobiDS is a meromorphic function in both arguments.
  • For certain special arguments, JacobiDS automatically evaluates to exact values.
  • JacobiDS can be evaluated to arbitrary numerical precision.
  • JacobiDS automatically threads over lists.


open allclose all

Basic Examples  (4)

Evaluate numerically:

Plot the function over a subset of the reals:

Plot over a subset of the complexes:

Series expansions at the origin:

Scope  (27)

Numerical Evaluation  (4)

Evaluate numerically to high precision:

The precision of the output tracks the precision of the input:

Evaluate for complex arguments:

Evaluate JacobiDS efficiently at high precision:

JacobiDS threads elementwise over lists:

Specific Values  (3)

Simple exact values are generated automatically:

Some poles of JacobiDS:

Find a local minimum of JacobiDS as a root of (d)/(dx)TemplateBox[{x, {1, /, 3}}, JacobiDS]=0:

Visualization  (3)

Plot the JacobiDS functions for various parameter values:

Plot JacobiDS as a function of its parameter :

Plot the real part of TemplateBox[{{x, +, {ⅈ,  , y}}, {1, /, 2}}, JacobiDS]:

Plot the imaginary part of TemplateBox[{{x, +, {ⅈ,  , y}}, {1, /, 2}}, JacobiDS]:

Function Properties  (2)

JacobiDS is 4TemplateBox[{m}, EllipticK]-periodic along the real axis:

JacobiDS is 4ⅈTemplateBox[{{1, -, m}}, EllipticK]-periodic along the imaginary axis:

JacobiDS is an odd function:

Differentiation  (3)

First derivative:

Higher derivatives:

Plot higher derivatives for :

Derivative with respect to :

Integration  (3)

Indefinite integral of JacobiDS:

Definite integral of an odd function over the interval centered at the origin is 0:

More integrals:

Series Expansions  (3)

Series expansion for TemplateBox[{x, {1, /, 3}}, JacobiDS]:

Plot the first three approximations for TemplateBox[{x, {1, /, 3}}, JacobiDS] around :

Taylor expansion for TemplateBox[{1, m}, JacobiDS]:

Plot the first three approximations for TemplateBox[{1, m}, JacobiDN] around :

JacobiDS can be applied to a power series:

Function Identities and Simplifications  (3)

Parity transformation and periodicity relations are automatically applied:

Identity involving JacobiCS:

Argument simplifications:

Function Representations  (3)

Representation in terms of Csc of JacobiAmplitude:

Relation to other Jacobi elliptic functions:

TraditionalForm formatting:

Applications  (4)

Conformal map from a rectangle to the unit disk:

Visualize the map:

Generator for the hierarchy of solutions of the nonlinear diffusion equation :

Numerical check of the solutions:

Conformal map from an ellipse to the unit disk:

Visualize the map:

Cartesian coordinates of a pendulum:

Plot the timedependence of the coordinates:

Plot the trajectory:

Properties & Relations  (2)

Compose with inverse functions:

Use PowerExpand to disregard multivaluedness of the inverse function:

Solve a transcendental equation:

Possible Issues  (2)

Machine-precision input is insufficient to give the correct answer:

Currently only simple simplification rules are built in for Jacobi functions:

Introduced in 1988