Skip to content

JacobiNC ​

The Jacobi elliptic function nc⁡(u,m)=1/cn⁡(u,m)\operatorname{nc}(u,m) = 1/\operatorname{cn}(u,m) (Glaisher's notation), in Wolfram/mpmath's m=k2m=k^2 convention.

✓ checked against that system · ! checked, with disagreements (hover a chip)Wolfram LanguageJacobiNC!
JacobiNC(u, m)the Jacobi elliptic function nc, argument u, parameter m.
SageMathjacobi_nc(u, m)mpmathellipfun('nc', u, m=m)Juliaenumeratio_jacobi(:nc, u, m)
Typed signatures
TypePackageApplies
(number, number) -> numberanalyticalways

Domain: Special functions

Details
  • m=k2m = k^2, the same convention EllipticK / EllipticF use.
  • nc⁡(u,m)=1/cn⁡(u,m)\operatorname{nc}(u,m) = 1/\operatorname{cn}(u,m) — JacobiCN shares this head's numeric kernel and exact-value coverage (m outside [0,1] via the reciprocal- and imaginary-modulus transformations, complex u, a genuinely complex m declined).
  • nc(0,m) = 1, for any m; nc has a pole at the quarter period u = EllipticK(m) (cn = 0 there).
  • Numeric only — a symbolic argument stays unevaluated; a floating-point argument (or N()) evaluates directly.
  • N(x, d) past a double's digits runs the same AGM in BigDecimal for real uu and 0<m<10 < m < 1; complex uu and other mm stay unevaluated there rather than print a double's digits as more.
  • Derivatives of every order in uu and in mm are closed forms in sn, cn, dn and the Jacobi epsilon E(u,m)=Z(u,m)+u E(m)/K(m)\mathcal{E}(u,m)=Z(u,m)+u\,E(m)/K(m) (DLMF 22.13): D, Series in uu at 00 or at a symbolic point, and Series in mm at m=0m=0 all give concrete coefficients. The mm-derivatives evaluate numerically for real uu and mm between 0 and 1.

Plot

Examples

Basic #

A floating-point argument evaluates directly to a decimal

live ↗
InN(JacobiNC(0.3,1.5))N(\mathrm{JacobiNC}(0.3, 1.5))Out1.044 645 321 516 758 41.044\,645\,321\,516\,758\,4

Known value · mpmath 1.3.0 ellipfun

live ↗
InSeries⁡(JacobiNC(z,m),z,0,7)\operatorname{Series}(\mathrm{JacobiNC}(z, m), z, 0, 7)Out1+z22+124(5−4m)z4+1720(16m2−76m+61)z6+O(z8)1+\frac{z^2}{2}+\frac{1}{24}(5-4m)z^4+\frac{1}{720}(16m^2-76m+61)z^6+O\left(z^8\right)
live ↗
InSeries⁡(JacobiNC(z,m),m,0,1)\operatorname{Series}(\mathrm{JacobiNC}(z, m), m, 0, 1)Out1cos⁡(z)+m×(−4zsin⁡(z)−cos⁡(3z)+cos⁡(z))16cos⁡(z)2+O(m2)\frac{1}{\cos(z)}+\frac{m×(-4z\sin(z)-\cos(3z)+\cos(z))}{16\cos(z)^2}+O\left(m^2\right)
Scope #

m less than 0, via the imaginary-modulus transformation

live ↗
InN(JacobiNC(0.3,−2))N(\mathrm{JacobiNC}(0.3, -2))Out1.049 687 404 895 594 61.049\,687\,404\,895\,594\,6

K(0) = π/2, where cn is 0: the quarter-period pole holds at m = 0 too, not just cos(K(0)) left symbolic

live ↗
InJacobiNC(EllipticK(0),0)\mathrm{JacobiNC}(\mathrm{EllipticK}(0), 0)Out∞~\tilde∞

Known value · Wolfram MathematicalFunctionData, JacobiNC

At m=1m=1, nc is cosh, giving 12\frac12 at −iπ/3-i\pi/3

live ↗
InMatrixFunction(_1⁡↦JacobiNC((−(1/3)i)π,_1⁡),[[1,0],[0,1]])\mathrm{MatrixFunction}(\operatorname{\_1}↦\mathrm{JacobiNC}((-(1/3)i)π, \operatorname{\_1}), \bigl\lbrack\bigl\lbrack1, 0\bigr\rbrack, \bigl\lbrack0, 1\bigr\rbrack\bigr\rbrack)Out[[12,0],[0,12]]\bigl\lbrack\bigl\lbrack\frac{1}{2}, 0\bigr\rbrack, \bigl\lbrack0, \frac{1}{2}\bigr\rbrack\bigr\rbrack
live ↗
In[JacobiNC(z,0),JacobiNC(z,1)]\bigl\lbrack\mathrm{JacobiNC}(z, 0), \mathrm{JacobiNC}(z, 1)\bigr\rbrackOut[1cos⁡(z),cosh⁡(z)]\bigl\lbrack\frac{1}{\cos(z)}, \cosh(z)\bigr\rbrack
live ↗
InN(JacobiNC(2,13),50)N(\mathrm{JacobiNC}(2, \frac{1}{3}), 50)Out−4.621 534 048 480 796 847 474 129 165 488 820 572 291 436 878 365 7-4.621\,534\,048\,480\,796\,847\,474\,129\,165\,488\,820\,572\,291\,436\,878\,365\,7
live ↗
In[JacobiNC(0,m),JacobiNC(EllipticK(m)2,m),JacobiNC(iEllipticK(1−m),m)]\bigl\lbrack\mathrm{JacobiNC}(0, m), \mathrm{JacobiNC}(\frac{\mathrm{EllipticK}(m)}{2}, m), \mathrm{JacobiNC}(i\mathrm{EllipticK}(1-m), m)\bigr\rbrackOut[1,JacobiNC(EllipticK(m)2,m),JacobiNC(iEllipticK(1−m),m)]\bigl\lbrack1, \mathrm{JacobiNC}(\frac{\mathrm{EllipticK}(m)}{2}, m), \mathrm{JacobiNC}(i\mathrm{EllipticK}(1-m), m)\bigr\rbrack
live ↗
In[JacobiNC(EllipticK(m),m),JacobiNC(3EllipticK(m),m),JacobiNC(2iEllipticK(1−m)+EllipticK(m),m)]\bigl\lbrack\mathrm{JacobiNC}(\mathrm{EllipticK}(m), m), \mathrm{JacobiNC}(3\mathrm{EllipticK}(m), m), \mathrm{JacobiNC}(2i\mathrm{EllipticK}(1-m)+\mathrm{EllipticK}(m), m)\bigr\rbrackOut[∞~,JacobiNC(3EllipticK(m),m),JacobiNC(2iEllipticK(1−m)+EllipticK(m),m)]\bigl\lbrack\tilde∞, \mathrm{JacobiNC}(3\mathrm{EllipticK}(m), m), \mathrm{JacobiNC}(2i\mathrm{EllipticK}(1-m)+\mathrm{EllipticK}(m), m)\bigr\rbrack
live ↗
InSeries⁡(JacobiNC(x,13),x,0,7)\operatorname{Series}(\mathrm{JacobiNC}(x, \frac{1}{3}), x, 0, 7)Out1+x22+11x472+337x66 480+O(x8)1+\frac{x^2}{2}+\frac{11x^4}{72}+\frac{337x^6}{6\,480}+O\left(x^8\right)
live ↗
InFullSimplify(Series⁡(JacobiNC(1,m),m,0,3))\mathrm{FullSimplify}(\operatorname{Series}(\mathrm{JacobiNC}(1, m), m, 0, 3))Out1cos⁡(1)+m×(−4sin⁡(1)−cos⁡(3)+cos⁡(1))16cos⁡(1)2+(35−44sin⁡(2)−11cos⁡(4)−8cos⁡(2)−4sin⁡(4))m2512cos⁡(1)3+(−2 416sin⁡(1)−1 840sin⁡(3)−633cos⁡(3)−387cos⁡(5)−192sin⁡(5)+3cos⁡(7)+2 745cos⁡(1))m349 152cos⁡(1)4+O(m4)\frac{1}{\cos(1)}+\frac{m×(-4\sin(1)-\cos(3)+\cos(1))}{16\cos(1)^2}+\frac{(35-44\sin(2)-11\cos(4)-8\cos(2)-4\sin(4))m^2}{512\cos(1)^3}+\frac{(-2\,416\sin(1)-1\,840\sin(3)-633\cos(3)-387\cos(5)-192\sin(5)+3\cos(7)+2\,745\cos(1))m^3}{49\,152\cos(1)^4}+O\left(m^4\right)

The derivative in the parameter m, in closed form through the Jacobi zeta

live ↗
IndJacobiNC(u,m)dm\frac{\mathrm{d}\mathrm{JacobiNC}(u, m)}{\mathrm{d}m}Out−(uEllipticE(m)EllipticK(m)+JacobiZN(u,m))JacobiSN(u,m)JacobiDN(u,m)2m×(1−m)JacobiCN(u,m)2+uJacobiSN(u,m)JacobiDN(u,m)2mJacobiCN(u,m)2+JacobiSN(u,m)22(1−m)JacobiCN(u,m)-\frac{(\frac{u\mathrm{EllipticE}(m)}{\mathrm{EllipticK}(m)}+\mathrm{JacobiZN}(u, m))\mathrm{JacobiSN}(u, m)\mathrm{JacobiDN}(u, m)}{2m×(1-m)\mathrm{JacobiCN}(u, m)^2}+\frac{u\mathrm{JacobiSN}(u, m)\mathrm{JacobiDN}(u, m)}{2m\mathrm{JacobiCN}(u, m)^2}+\frac{\mathrm{JacobiSN}(u, m)^2}{2(1-m)\mathrm{JacobiCN}(u, m)}
Properties #

u = 0 is 1, for any m

live ↗
InJacobiNC(0,m)\mathrm{JacobiNC}(0, m)Out11

nc(0) is 1

live ↗
InJacobiNC(0,0)\mathrm{JacobiNC}(0, 0)Out11

Known value · Wolfram MathematicalFunctionData, JacobiNC

At m=0m=0, nc=sec⁡\mathrm{nc}=\sec, a pole at π/2\pi/2

live ↗
InJacobiNC(π2,0)\mathrm{JacobiNC}(\frac{π}{2}, 0)Out∞~\tilde∞

Known value · Wolfram MathematicalFunctionData, JacobiNC

nc(0) is 1 at m=1m=1 too

live ↗
InJacobiNC(0,1)\mathrm{JacobiNC}(0, 1)Out11

Known value · Wolfram MathematicalFunctionData, JacobiNC

At m=1m=1 cosh vanishes at iπ/2i\pi/2

live ↗
InJacobiNC(12iπ,1)\mathrm{JacobiNC}(\frac{1}{2}i π, 1)Out00

Known value · Wolfram MathematicalFunctionData, JacobiNC

live ↗
InN(JacobiNC(21/24i,2))N(\mathrm{JacobiNC}(\frac{2^{1/2}}{4}i, 2))Out0.935 622 687 124 812 20.935\,622\,687\,124\,812\,2

Known value · Wolfram MathematicalFunctionData, JacobiNC, Landen's transformation

live ↗
InN(JacobiNC(12(1+21/22),(1−21/2/2)2(1+21/2/2)2))N(\mathrm{JacobiNC}(\frac{1}{2}(1+\frac{2^{1/2}}{2}), \frac{(1-2^{1/2}/2)^2}{(1+2^{1/2}/2)^2}))Out1.516 776 888 094 9371.516\,776\,888\,094\,937

Known value · Wolfram MathematicalFunctionData, JacobiNC, Gauss' transformation

live ↗
InN(JacobiNC(2i,2))N(\mathrm{JacobiNC}(\sqrt{2}i, 2))Out−0.145 153 002 614 799 13-0.145\,153\,002\,614\,799\,13

Known value · Wolfram MathematicalFunctionData, JacobiNC, Landen's transformation

live ↗
InN(JacobiNC(2(1+22),(1−21/2/2)2(1+21/2/2)2))N(\mathrm{JacobiNC}(2(1+\frac{\sqrt{2}}{2}), \frac{(1-2^{1/2}/2)^2}{(1+2^{1/2}/2)^2}))Out−1.031 831 310 280 545 4-1.031\,831\,310\,280\,545\,4

Known value · Wolfram MathematicalFunctionData, JacobiNC, Gauss' transformation

Possible issues #

Symbolic arguments are left unevaluated rather than guessed at

live ↗
InJacobiNC(u,m)\mathrm{JacobiNC}(u, m)OutJacobiNC(u,m)\mathrm{JacobiNC}(u, m)
About
Examples23
Checked againstWolfram Language 21 agree2 differSageMath 17 agree3 differ2 errormpmath 10 agree2 unevaluatedJulia 9 agree3 error
CrosswalkWolfram LanguageSageMathmpmathJulia

Implementation

mappedmpmathpackages/oracle/src/mappings.ts
mappedsagepackages/oracle/src/mappings.ts
mappedjuliapackages/oracle/src/mappings.ts
mappedsympypackages/oracle/src/mappings.ts

SymPy has no Jacobi elliptic functions: sympy.jacobi is the Jacobi polynomial P_n^(a,b), not sn/cn/dn, and there is no ellipfun (mpmath, Sage and Nemo carry them).

See also: JacobiCN, JacobiCD, JacobiDC