Skip to content

JacobiSC ​

The Jacobi elliptic function sc⁡(u,m)=sn⁡(u,m)/cn⁡(u,m)\operatorname{sc}(u,m) = \operatorname{sn}(u,m)/\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 LanguageJacobiSC!
JacobiSC(u, m)the Jacobi elliptic function sc, argument u, parameter m.
SageMathjacobi_sc(u, m)mpmathellipfun('sc', u, m=m)Juliaenumeratio_jacobi(:sc, u, m)
Typed signatures
TypePackageApplies
(number, number) -> numberanalyticalways

Domain: Special functions

Details
  • m=k2m = k^2, the same convention EllipticK / EllipticF use.
  • sc⁡(u,m)=sn⁡(u,m)/cn⁡(u,m)\operatorname{sc}(u,m) = \operatorname{sn}(u,m)/\operatorname{cn}(u,m) — JacobiSN and JacobiCN share 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).
  • sc(0,m) = 0, for any m.
  • 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(JacobiSC(0.6,0.4))N(\mathrm{JacobiSC}(0.6, 0.4))Out0.664 744 322 732 858 70.664\,744\,322\,732\,858\,7

Known value · mpmath 1.3.0 ellipfun

Scope #

m greater than 1, via the reciprocal-modulus transformation

live ↗
InN(JacobiSC(1.2,3))N(\mathrm{JacobiSC}(1.2, 3))Out0.666 077 181 942 274 20.666\,077\,181\,942\,274\,2

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

live ↗
IndJacobiSC(u,m)dm\frac{\mathrm{d}\mathrm{JacobiSC}(u, m)}{\mathrm{d}m}Out−(uEllipticE(m)EllipticK(m)+JacobiZN(u,m))JacobiDN(u,m)2m×(1−m)+uJacobiDN(u,m)2m−(uEllipticE(m)EllipticK(m)+JacobiZN(u,m))JacobiDN(u,m)JacobiSN(u,m)22m×(1−m)JacobiCN(u,m)2+uJacobiDN(u,m)JacobiSN(u,m)22mJacobiCN(u,m)2+JacobiSN(u,m)JacobiCN(u,m)2(1−m)+JacobiSN(u,m)32(1−m)JacobiCN(u,m)-\frac{(\frac{u\mathrm{EllipticE}(m)}{\mathrm{EllipticK}(m)}+\mathrm{JacobiZN}(u, m))\mathrm{JacobiDN}(u, m)}{2m×(1-m)}+\frac{u\mathrm{JacobiDN}(u, m)}{2m}-\frac{(\frac{u\mathrm{EllipticE}(m)}{\mathrm{EllipticK}(m)}+\mathrm{JacobiZN}(u, m))\mathrm{JacobiDN}(u, m)\mathrm{JacobiSN}(u, m)^2}{2m×(1-m)\mathrm{JacobiCN}(u, m)^2}+\frac{u\mathrm{JacobiDN}(u, m)\mathrm{JacobiSN}(u, m)^2}{2m\mathrm{JacobiCN}(u, m)^2}+\frac{\mathrm{JacobiSN}(u, m)\mathrm{JacobiCN}(u, m)}{2(1-m)}+\frac{\mathrm{JacobiSN}(u, m)^3}{2(1-m)\mathrm{JacobiCN}(u, m)}

The Taylor series at u = 0, its coefficients polynomials in m

live ↗
InSeries⁡(JacobiSC(u,m),u,0,5)\operatorname{Series}(\mathrm{JacobiSC}(u, m), u, 0, 5)Outu+16(2−m)u3+1120(m2−16m+16)u5+O(u7)u+\frac{1}{6}(2-m)u^3+\frac{1}{120}(m^2-16m+16)u^5+O\left(u^7\right)

The series in the parameter m at m = 0, its coefficients trigonometric in z

live ↗
InSeries⁡(JacobiSC(z,m),m,0,2)\operatorname{Series}(\mathrm{JacobiSC}(z, m), m, 0, 2)Outsin⁡(z)cos⁡(z)+m×(sin⁡(2z)−2z)8cos⁡(z)2+(32sin⁡(z)z2−72zcos⁡(z)+19sin⁡(3z)+20sin⁡(z)−sin⁡(5z))m2512cos⁡(z)3+O(m3)\frac{\sin(z)}{\cos(z)}+\frac{m×(\sin(2z)-2z)}{8\cos(z)^2}+\frac{(32\sin(z)z^2-72z\cos(z)+19\sin(3z)+20\sin(z)-\sin(5z))m^2}{512\cos(z)^3}+O\left(m^3\right)
Properties #

u = 0 is 0, for any m

live ↗
InJacobiSC(0,m)\mathrm{JacobiSC}(0, m)Out00
live ↗
InN(JacobiSC(21/24i,−1))N(\mathrm{JacobiSC}(\frac{2^{1/2}}{4}i, -1))Out0.332 870 852 168 694 55i0.332\,870\,852\,168\,694\,55i

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

live ↗
InN(JacobiSC(12(1+21/22),(1−21/2/2)2(1+21/2/2)2))N(\mathrm{JacobiSC}(\frac{1}{2}(1+\frac{2^{1/2}}{2}), \frac{(1-2^{1/2}/2)^2}{(1+2^{1/2}/2)^2}))Out1.140 443 829 506 2851.140\,443\,829\,506\,285

Known value · Wolfram MathematicalFunctionData, JacobiSC, Gauss' transformation

live ↗
InN(JacobiSC(2i,−1))N(\mathrm{JacobiSC}(\sqrt{2}i, -1))Out0.703 332 475 251 434 3i0.703\,332\,475\,251\,434\,3i

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

live ↗
InN(JacobiSC(2(1+22),(1−21/2/2)2(1+21/2/2)2))N(\mathrm{JacobiSC}(2(1+\frac{\sqrt{2}}{2}), \frac{(1-2^{1/2}/2)^2}{(1+2^{1/2}/2)^2}))Out0.254 314 476 338 385 10.254\,314\,476\,338\,385\,1

Known value · Wolfram MathematicalFunctionData, JacobiSC, Gauss' transformation

Possible issues #

Symbolic arguments are left unevaluated rather than guessed at

live ↗
InJacobiSC(u,m)\mathrm{JacobiSC}(u, m)OutJacobiSC(u,m)\mathrm{JacobiSC}(u, m)

u = iπ/2 is a pole of sn AND cn individually (both ~oo at m = 1), but their ratio is finite — sharing one denominator in the m = 1 exact table (see jacobi-elliptic.ts) keeps this from an unresolved ComplexInfinity/ComplexInfinity.

live ↗
InN(JacobiSC(iπ2,1))N(\mathrm{JacobiSC}(\frac{i π}{2}, 1))Out1.0i1.0i

Known value · mpmath 1.3.0 ellipfun

Same gap as JacobiCD (the true value is tracked there, not repeated per head): u this far out has no argument reduction against its real period, so the guard in exceedsDoublePrecision's sibling (periodsExceedDouble, ce-patches/support/precise.ts) declines rather than return a wrong value.

live ↗
InN(JacobiSC(1016,14))N(\mathrm{JacobiSC}(10^{16}, \frac{1}{4}))OutJacobiSC(10 000 000 000 000 000.0,0.25)\mathrm{JacobiSC}(10\,000\,000\,000\,000\,000.0, 0.25)
About
Examples13
Checked againstWolfram Language 12 agree1 differSageMath 10 agree1 differ1 unevaluated1 errormpmath 7 agree1 unevaluatedJulia 6 agree1 unevaluated1 error
CrosswalkWolfram LanguageSageMathmpmathJulia

Implementation

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

See also: JacobiSN, JacobiCN, JacobiCS