distparser 0.3.1

Parse function-call strings into frozen scipy.stats distributions

distparser

Parse function‑call strings into frozen scipy.stats distributions — with dependency resolution, arithmetic expressions, and seed management.

Installation

pip install distparser

Quick Start

import distparser as lib

# Parse a single distribution string
d = lib.parse_dist("norm(loc=0, scale=1)")
print(d.rvs(size=3))  # array([...])

DistGraph — dependency-aware evaluation

from distparser import DistGraph

config = {
    "mean": 5.0,
    "noise": "norm(0, 0.1)",
    "measurement": "mean + noise",
}

graph = DistGraph(config, seed=42)
result = graph.resolve_all()
print(result["measurement"])  # 5.0 + sample from N(0, 0.1)

Features

• 15 built-in distributions — uniform, norm, expon, gamma, beta, lognorm, weibull_min, t, chi2, f, pareto, cauchy, laplace, logistic, rayleigh
• Distribution aliases — normal → norm, gaussian → norm, unif → uniform
• DistGraph — automatic dependency resolution via topological sort
• Arithmetic expressions — "60 + 30 * uniform(0, 1)" with sin, cos, exp, sqrt, pi and more
• Seed management — global seed(), context manager seed_context(), per-instance DistGraph(seed=...)
• Bounds constraints — annotate parameters with physical limits for downstream validation
• Extensible registry — register custom distributions at runtime

Docs

Full documentation at distparser.readthedocs.io.

Development

See AGENTS.md for setup and guidelines.

License

MIT