Skip to main content

A library for elliptic functions

Project description

License: GPL v3

Elliptix

A library of algorithms for evaluating elliptic functions of a complex argument.

Installation

To install Elliptix, run the following command in your terminal:

pip install elliptix

Documentation

As of right now, the documentation is handled through function Docstrings in the source file.

Implemented Functions

— The Jacobi Theta functions: $\theta_n(z, q) ; n=1, 2, 3, 4$

jacobi_theta(n, z, q)

— The natural logarithm of the Jacobi Theta functions: $\log(\theta_n(z, q)) ; n=1, 2, 3, 4$

log_jacobi_theta(n, z, q)

— The Weierstrass elliptic functions: $\wp(z; g_2, g_3), \wp'(z; g_2, g_3), \wp^{-1}(w; g_2, g_3), \sigma(z; g_2, g_3), \zeta(z; g_2, g_3)$

weierstrass_p(z, g2, g3)
weierstrass_p_prime(z, g2, g3)
inverse_weierstrass_p(z, g2, g3)
weierstrass_sigma(z, g2, g3)
weierstrass_zeta(z, g2, g3)

— The conversion functions between the modulus $k,$ the parameter $m,$ the half-period ratio $\tau,$ the nome $q,$ the lattice roots $e_1, e_2, e_3,$ the invariants $g_2, g_3,$ the half-periods $\omega_1, \omega_2, \omega_3,$ and the values of the Weierstrass $\zeta$ function at the half-periods $\eta_1, \eta_2, \eta_3$

modulus_k(...)
parameter_m(...)
half_period_ratio_tau(...)
nome_q(...)
weierstrass_e(...)
weierstrass_g(...)
weierstrass_w(...)
weierstrass_eta(...)

— Modular functions: $J(\tau)$, $J^{-1}(\tau)$, $\lambda(\tau)$, $\eta(\tau)$, $\eta'(\tau)$, $G_n(q)$, $E_n(q)$, $\phi(q)$

klein_j(tau)
inverse_klein_j(tau)
modular_lambda(tau)
dedekind_eta(tau)
dedekind_eta_prime(tau)
eisenstein_g(n, q)
eisenstein_e(n, q)
euler_phi(q)

— The Jacobi elliptic functions: $\text{sn}(u, m), \text{cn}(u, m), \text{dn}(u, m), \text{am}(u, m), ...$ and their inverses: $\text{sn}^{-1}(w, m), \text{cn}^{-1}(w, m), ...$

jacobi_ellipfun("sn", u, m)
jacobi_ellipfun("cn", u, m)
jacobi_ellipfun("dn", u, m)
jacobi_ellipfun("am", u, m)
...
inverse_jacobi_ellipfun("sn", u, m)
inverse_jacobi_ellipfun("cn", u, m)
...

— The Neville Theta functions: $\theta_c(u, m), \theta_d(u, m), \theta_n(u, m), \theta_s(u, m)$

neville_theta_c(u, m)
neville_theta_d(u, m)
neville_theta_n(u, m)
neville_theta_s(u, m)

— The Lemniscate elliptic functions: $\text{sinlem}(z), \text{coslem}(z), \text{sinhlem}(z), \text{coshlem}(z)$ and their inverses: $\text{arcsinlem}(z), \text{arccoslem}(z), \text{arcsinhlem}(z), \text{arccoshlem}(z)$

sinlem(z)
coslem(z)
sinhlem(z)
arcsinlem(z)
arcsinhlem(z)
...

Complex Plots

Plotting the elliptic functions on the complex plane using domain coloring reveals beautiful repeating patterns. All functions were plotted using elliptix.plot.ComplexPlot at 1500x1500 pixel resolution.

The Weierstrass ℘ function.
The Weierstrass ℘ function.


The Weierstrass σ function.
The Weierstrass σ function.


The Jacobi sc function.
The Jacobi sc function.


The Eisenstein G₆ series as a function of q.
The Eisenstein G₆ series as a function of q.


The Eisenstein E₁₂ series as a function of τ.
The Eisenstein E₁₂ series as a function of τ.


The Absolute Klein J invariant as a function of τ.
The Absolute Klein J invariant as a function of τ.


The Dedekind η function as a function of τ.
The Dedekind η function as a function of τ.


The Modular λ function as a function of the nome, q.
The Modular λ function as a function of the nome, q.

Citation

@misc{elliptix,
  author       = {Rudolf Rosendorf},
  title        = {Elliptix: Algorithms for elliptic functions},
  month        = {June},
  year         = {2026},
  publisher    = {GitHub},
  journal      = {GitHub repository},
  howpublished = {\url{https://github.com/Ruda975/elliptix}}
}

References

  • [DLMF] NIST Digital Library of Mathematical Functions. https://dlmf.nist.gov/, Release 1.2.6 of 2026-03-15. F. W. J. Olver, A. B. Olde Daalhuis, D. W. Lozier, B. I. Schneider, R. F. Boisvert, C. W. Clark, B. R. Miller, B. V. Saunders, H. S. Cohl, and M. A. McClain, eds.

  • Weisstein, E. W. (n.d.). MathWorld. Wolfram Research. https://mathworld.wolfram.com/.

  • The Mathematical Functions Site. Wolfram Research, Inc., https://functions.wolfram.com/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elliptix-1.1.1.tar.gz (3.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

elliptix-1.1.1-py3-none-any.whl (54.8 kB view details)

Uploaded Python 3

File details

Details for the file elliptix-1.1.1.tar.gz.

File metadata

  • Download URL: elliptix-1.1.1.tar.gz
  • Upload date:
  • Size: 3.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for elliptix-1.1.1.tar.gz
Algorithm Hash digest
SHA256 09fefe2cb02d929ee086ed3715010e88cbcc0f9eaafbe589310cf519cc4725d6
MD5 1a73cb0fdfe3c6dd9ba8b865da64c024
BLAKE2b-256 757b1e4d2bb70373d35e7adebeb82b16ab8374c1c783ba8b3217c0c5ad2c5b4b

See more details on using hashes here.

File details

Details for the file elliptix-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: elliptix-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 54.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for elliptix-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ad28e2e6a1c0b552342a703f1e25f5c60146c87f1281e85f998229d5e16444e4
MD5 7bbc96d0475fb38a04c63b0ab87ab5e3
BLAKE2b-256 42bd198edeb919268985bfffaf84e4d31068437a19f9702ffd4617702c1c9de4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page