ellippy.legendre.ellipdinc

ellippy.legendre.ellipdinc(phi, m)

Computes incomplete elliptic integral of Legendre’s type D(φ | m).

\[D(\varphi\,|\,m) = \int_0^{\varphi} \frac{\sin^2\theta}{\sqrt{1 - m\,\sin^2\theta}}\,\mathrm{d}\theta\]

Parameters:

• phi (ArrayLike) – Amplitude angle (φ) in radians. φ ∈ ℝ.

• m (ArrayLike) – Elliptic parameter. m ∈ ℝ.

Returns:

Scalar or numpy.ndarray broadcast from phi and m.

Raises:

ValueError – If m sin²φ > 1 or inputs contain NaN.

Graph

Special Cases

• D(0, m) = 0

• D(π/2, m) = D(m)

• D(φ, -∞) = 0

• D(±∞, m) = ±∞

Related Functions

With c = csc²φ,

• D(φ, m) = (F(φ, m) - E(φ, m)) / m

• D(φ, m) = RD(c - 1, c - m, c) / 3

Notes

The elliptic modulus k is frequently used instead of m, where k² = m.

References

• Carlson, B. C. “DLMF: Chapter 19 Elliptic Integrals.” Accessed February 19, 2025. https://dlmf.nist.gov/19.

• Maddock, John, Paul Bristow, Hubert Holin, and Xiaogang Zhang. “Boost Math Library: Special Functions - Elliptic Integrals.” Accessed April 17, 2025. https://www.boost.org/doc/libs/1_88_0/libs/math/doc/html/math_toolkit/ellint.html.

• Pornsiriprasert, Sira. Ellip: Elliptic Integrals for Rust. V. 0.5.1. Released October 10, 2025. https://docs.rs/ellip/0.5.1/ellip/index.html.