Legendre's elliptic integrals #
This file defines Legendre's incomplete elliptic integrals of the first, second and third kinds
(DLMF 19.2.4, 19.2.5, 19.2.7), as functions of a real amplitude φ, a real modulus k and a real
characteristic α2 (written α² in prose; it may be negative):
TauCeti.Real.legendreF φ k = ∫ θ in 0..φ, (1 - k ^ 2 * sin θ ^ 2) ^ (-1 / 2);TauCeti.Real.legendreE φ k = ∫ θ in 0..φ, (1 - k ^ 2 * sin θ ^ 2) ^ (1 / 2);TauCeti.Real.legendrePi φ k α2is the integral over[0, φ]of(1 - α2 * sin θ ^ 2)⁻¹ * (1 - k ^ 2 * sin θ ^ 2) ^ (-1 / 2);
together with the complete integrals legendreK k, legendreEc k and legendrePic k α2, their
values at φ = π / 2. The powers are Real.rpow. These are total functions of their real
arguments; their values are meaningful for k ^ 2 < 1 and α2 < 1, under which every integrand
is continuous and bounded between two positive constants, and every theorem below states the
hypotheses it needs. The integral of the second kind needs no hypothesis at all for the bounds on
its integrand, nor for continuity, differentiability, positivity and quasi-periodicity in φ, and
it is strictly increasing in φ for k ^ 2 ≤ 1.
We prove the basic theory in the amplitude:
- the integrands are continuous, positive, bounded by explicit constants and interval integrable;
- the fundamental theorem of calculus
HasDerivAt (legendreF · k) ((1 - k ^ 2 * sin φ ^ 2) ^ (-1 / 2)) φand its analogues, so the three integrals are continuous and strictly increasing inφ, and positive forφ > 0; in particular the complete integrals are positive; - the integrals are odd in
φand even ink; - quasi-periodicity:
legendreF (φ + n * π) k = legendreF φ k + 2 * n * legendreK kfor integersn, and likewise for the other two kinds; in particular the Lebesgue integral of the integrand of the first kind over(0, π)is2 * legendreK k; legendreFOrderIso: fork ^ 2 < 1, the mapφ ↦ legendreF φ kis an order isomorphism ofℝ, whose inverse is the Jacobi amplitude;- the degenerate modulus
k = 0:legendreF φ 0 = legendreE φ 0 = φ, andlegendreK 0 = legendreEc 0 = π / 2; - the characteristic
α2 = 0:legendrePi φ k 0 = legendreF φ k. - on
[0, π / 2], the integrals of the second and third kinds in terms of the first (legendreE_eq_legendreF_sub,legendrePi_eq_legendreF_add).
The conventions (modulus rather than parameter, argument order (φ, k) and (φ, k, α2)) are
those of DLMF Chapter 19 and of B. Braams' lean-codes formalization of B. C. Carlson's
Special Functions of Applied Mathematics, so that the two developments stay interoperable.
References #
- NIST Digital Library of Mathematical Functions, §19.2, https://dlmf.nist.gov/19.2.
- B. C. Carlson, Special Functions of Applied Mathematics, Academic Press, 1977, Chapter 9.
Definitions #
Legendre's incomplete elliptic integral of the first kind (DLMF 19.2.4),
F(φ, k) = ∫₀^φ (1 - k² sin² θ)^(-1/2) dθ, with amplitude φ and modulus k. It is meaningful
for k ^ 2 < 1.
Instances For
Legendre's incomplete elliptic integral of the second kind (DLMF 19.2.5),
E(φ, k) = ∫₀^φ (1 - k² sin² θ)^(1/2) dθ, with amplitude φ and modulus k. It is meaningful
for k ^ 2 ≤ 1.
Instances For
Legendre's incomplete elliptic integral of the third kind (DLMF 19.2.7),
Π(φ, k, α²) = ∫₀^φ (1 - α² sin² θ)⁻¹ (1 - k² sin² θ)^(-1/2) dθ, with amplitude φ, modulus k
and characteristic α2, which may be negative. It is meaningful for k ^ 2 < 1 and α2 < 1.
Instances For
The complete elliptic integral of the first kind, K(k) = F(π/2, k).
Instances For
The complete elliptic integral of the second kind, E(k) = E(π/2, k).
Instances For
The complete elliptic integral of the third kind, Π(k, α²) = Π(π/2, k, α²).
Instances For
The integrands #
The first kind #
The second kind #
The third kind #
The integral of the first kind #
For k ^ 2 < 1, F(φ, k) is continuous in the amplitude φ.
For k ^ 2 < 1, F(φ, k) is strictly increasing in the amplitude φ.
For k ^ 2 < 1, the Lebesgue integral of the integrand of the first kind over (0, π) is
F(π, k) = 2 K(k), as an identity in ℝ≥0∞.
For k ^ 2 < 1, F(φ, k) tends to +∞ as the amplitude φ tends to +∞.
For k ^ 2 < 1, F(φ, k) tends to -∞ as the amplitude φ tends to -∞.
At modulus 0 the integral of the first kind is the identity: F(φ, 0) = φ.
The integral of the second kind #
For every modulus k, E(φ, k) is continuous in the amplitude φ.
For k ^ 2 ≤ 1, E(φ, k) is strictly increasing in the amplitude φ.
At modulus 0 the integral of the second kind is the identity: E(φ, 0) = φ.
For every modulus k, the complete integral of the second kind E(k) is positive.
Taking the absolute value of the modulus leaves the complete second kind unchanged.
The integral of the third kind #
At characteristic 0 the integral of the third kind is that of the first kind:
Π(φ, k, 0) = F(φ, k).
For k ^ 2 < 1 and α2 < 1, Π(φ, k, α²) is continuous in the amplitude φ.
For k ^ 2 < 1 and α2 < 1, Π(φ, k, α²) is strictly increasing in the amplitude φ.
Π(φ, k, α²) is odd in the amplitude.
Π(φ, k, α²) is even in the modulus.
The integral of the third kind in terms of the first:
Π(φ, k, α²) = F(φ, k) + α² ∫₀^φ sin² θ (1 - α² sin² θ)⁻¹ (1 - k² sin² θ)^(-1/2) dθ for
0 ≤ φ ≤ π / 2, k² sin² φ < 1 and α² sin² φ < 1.
For k ^ 2 < 1 and α2 < 1, the complete integral of the third kind Π(k, α²) is
positive.
Π(k, 0) = K(k).