Skip to main content

glmm

Linear-regression family — OLS → GLM → LMM → GLMM — in pure Rust, with a two-name Python API.

License: GPL-3.0-or-later

Fits fixed-effect and mixed (random-intercept / random-slope) models for Gaussian, Binomial (logit/probit), Poisson, Gamma, and Negative-Binomial outcomes. The numerics are the glmm Rust crate — no BLAS/LAPACK system dependency, no unsafe, validated against R/lme4 and Julia/MixedModels.jl goldens.

Install

pip install glmm

Requires Python 3.10+. The only runtime dependency is NumPy.

One call

You hand fit a data table and an R-style formula. It parses the formula against the table's columns, builds the design matrix, fits, and returns a Fit. There is no model object to construct.

import glmm

data = {
    "y":     [1.02, 1.05, 1.11, 1.13, 1.21, 1.24, 1.30, 1.33, 1.42, 1.44, 1.51, 1.53],
    "x1":    [0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 1.1],
    "group": ["a", "a", "b", "b", "c", "c", "d", "d", "e", "e", "f", "f"],
}

# y ~ x1 + (1 | group) — Gaussian, random intercept.
fit = glmm.fit(data, "y ~ x1 + (1 | group)")

assert fit.converged
fit.summary()   # prints the coefficient table (and returns it as a string)

The public surface is exactly two names: glmm.fit and glmm.Fit. Families, links, and knobs are string or scalar arguments, not types.

data is documented as a dict[str, array-like], but anything column-addressable works — pandas / polars DataFrame, pyarrow Table — by duck-typing, so there is no dataframe dependency.

Model routing

Routing is inferred from the formula and family — fixed-only means OLS/GLM, adding a (… | g) term makes it LMM/GLMM.

family default link other links fixed-only with (… | g)
gaussian identity OLS LMM
binomial logit probit GLM GLMM
poisson log GLM GLMM
gamma log inverse GLM GLMM
negativebinomial log GLM GLMM
fit = glmm.fit(data, "s ~ x1 + (1 | group)", "binomial", link="probit", nagq=7)

The formula follows R conventions: * desugars to main effects + interaction, A/B to nesting, (1 + x | g) is a correlated random intercept + slope, and additional (… | g2) terms add crossed or nested grouping factors. Treatment contrasts (R's default) code the factors against the column's first level; the full syntax, rejected constructs and workarounds, and factor-coding rules are in formula.md.

Not yet implemented

Four combinations have an approved design but no kernel support, and raise a clean NotImplementedError: family="inversegaussian", link="cloglog", quasi-likelihood dispersion= on binomial/poisson, and a float init_theta= seed (only the default init_theta=None cold start is supported). See troubleshooting.md for fixes to common errors.

Documentation

Full walkthrough — every knob, the Fit object, and warm starts: TUTORIAL-PYTHON.md.

The algorithm map (dispatch graph, solver paths, tuning knobs) is traced to code in documentation/algorithms.md.

License

GPL-3.0-or-later.


Paweł LenartowiczFreestyler Scientist · GitHub · ORCID

Download files

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

Source Distribution

glmm-0.1.2.tar.gz (699.5 kB view details)

Uploaded Source

Built Distributions

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

glmm-0.1.2-cp310-abi3-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.10+Windows x86-64

glmm-0.1.2-cp310-abi3-manylinux_2_28_x86_64.whl (2.0 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.28+ x86-64

glmm-0.1.2-cp310-abi3-macosx_11_0_arm64.whl (1.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file glmm-0.1.2.tar.gz.

File metadata

  • Download URL: glmm-0.1.2.tar.gz
  • Upload date:
  • Size: 699.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for glmm-0.1.2.tar.gz
Algorithm Hash digest
SHA256 f3de6968ca75bd37d2c1595e5279b6dfeca4edd6292fdb9e85e6e47ac9d8a7d9
MD5 8b1439953e79404a668c5f625af2f89f
BLAKE2b-256 3f1b774060634669607b7988f6fddf86adad7054e7a95acaf25c391913e04fe4

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.2.tar.gz:

Publisher: release.yml on pawlenartowicz/glmm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file glmm-0.1.2-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: glmm-0.1.2-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for glmm-0.1.2-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8405ff5110ad7253386fcc6960ccce4969fda982b45cc252d5683623e4178176
MD5 71902334135fac1e7c1eae75efcd4530
BLAKE2b-256 3ab16d9af2ce21be7a5ae13e51ad473e87fd1588f32cdd526cc0fdcac92c76d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.2-cp310-abi3-win_amd64.whl:

Publisher: release.yml on pawlenartowicz/glmm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file glmm-0.1.2-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for glmm-0.1.2-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7debb0e7a4d4a0c1dcd1edb528d0e96c72bd862ef730def4771c4d64879b87ad
MD5 a0004c217048b24fe1942216e3fb2e07
BLAKE2b-256 5df6822d9ebff24e0c6ce6c360435bf758017326bbdb20202b3f235c944095c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.2-cp310-abi3-manylinux_2_28_x86_64.whl:

Publisher: release.yml on pawlenartowicz/glmm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file glmm-0.1.2-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

  • Download URL: glmm-0.1.2-cp310-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.10+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for glmm-0.1.2-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0207e24b851ea1ce04577779d30c4dca2adb9cb21e815c9a17484d5524294892
MD5 d397ebe93b86f3f103d3eb6cc5a88273
BLAKE2b-256 321875734306753e4f51a58f2b56dddc4c3fe9c6f0b4d4a37aac7a2e6be0988a

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.2-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on pawlenartowicz/glmm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.1

4 files

0.3.0

4 files

0.2.0

4 files

0.1.3

4 files

This release

0.1.2 This release

4 files

0.1.1

4 files

0.1.0

4 files

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