eml-discover
Stable beta. Patent pending. Source-available; see LICENSE.
Identify famous mathematical formulas from arbitrary SymPy expressions. Curated registry of ~17 formulas across statistics, ML activations, trig/hyperbolic identities, physics, and finance — each tagged with its Pfaffian-cost class for fast structural pre-filtering.
Installation
pip install eml-discover
eml-cost is installed as a dependency; sympy>=1.12 required.
Quick start
import sympy as sp
from eml_discover import identify
u = sp.Symbol("u")
matches = identify(1 / (1 + sp.exp(-u)))
for m in matches:
print(m.formula.name, "—", m.confidence)
# sigmoid (canonical) — exact
matches = identify(sp.exp(-u**2 / 2) / sp.sqrt(2 * sp.pi))
print(matches[0].formula.name, matches[0].formula.description)
# Gaussian PDF (standardized) Standard normal probability density.
matches = identify("(log(S/K) + (r + vol**2/2)*T) / (vol*sqrt(T))")
print(matches[0].formula.citation)
# https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model
How it works
Two-stage match:
- Fingerprint pre-filter (cheap, structural). Every registry
template carries a Pfaffian fingerprint —
p3-d2-w1-c0-h7f3a91etc. Templates whose fingerprint axes don't match the user's expression are pruned in O(1) per template. - Symbolic equivalence (true match). Survivors are checked
under SymPy variable rename: for each candidate template, try
permutations of the user's free symbols, accept the rename if
sp.simplify(template - user) == 0.
Returns a list of Match ordered by confidence: identical (Python
equality, no rename) → exact (symbolic equivalence after rename)
→ axes (fingerprint axes match but no rename works).
Registry
Inspect what's registered:
from eml_discover import list_all, list_by_domain, by_name
list_all() # every Formula
list_by_domain("physics") # Bessel J_0, Airy Ai, Boltzmann factor, ...
by_name("Black-Scholes d1") # the d1 Formula
Add a formula by appending to eml_discover.registry.FORMULAS —
each entry is a small dataclass (name, expression_factory,
domain, description, citation).
Use cases
- "Wait, that's Black-Scholes." Surface familiar formulas hiding in user code or auto-generated symbolic-regression output.
- Curriculum tools. Tag a notebook's expressions by their registry name → automatic pedagogy ("this cell uses softplus").
- Patent / claim analysis. Compare a candidate's formula against the public registry of named identities.
Links
- Project home: monogate.org
- Source: github.com/almaguer1986/eml-discover
- Companion: eml-cost, eml-rewrite
License
PROPRIETARY-PRE-RELEASE. See LICENSE.
Metadata
Release files for eml-discover 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| eml_discover-0.2.0.tar.gz | 13.7 kB | Without provenance | Details for eml_discover-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| eml_discover-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for eml_discover-0.2.0-py3-none-any.whl |
Total release size: 25.0 kB
Release files / eml_discover-0.2.0.tar.gz
| Download URL | eml_discover-0.2.0.tar.gz |
|---|---|
| Size | 13.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
32578d0235052c69c6f44650df777febc05375d268c7ad03352b3c353496cd85
|
|
BLAKE2b-256 checksum How to use checksums |
324bfcb98e83481942ed347e1397e352ed88ac86a0b3bf1bfe5dccf97791acf7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / eml_discover-0.2.0-py3-none-any.whl
| Download URL | eml_discover-0.2.0-py3-none-any.whl |
|---|---|
| Size | 11.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
754af8042458c178046f8d98139a5e8b9c7f25d0e7dd1fd67c0abfc64b7fa4fa
|
|
BLAKE2b-256 checksum How to use checksums |
0805a5a3bddc9e9117c9e24f0435ca0538411f9ffb16d2a817dc3ecc22ad9d48
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for eml-discover 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.