Skip to main content

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:

  1. Fingerprint pre-filter (cheap, structural). Every registry template carries a Pfaffian fingerprint — p3-d2-w1-c0-h7f3a91 etc. Templates whose fingerprint axes don't match the user's expression are pruned in O(1) per template.
  2. 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.

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)

Source distribution for eml-discover 0.2.0
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)

Table of built distributions (wheels) for eml-discover 0.2.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page