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.3.tar.gz (707.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.3-cp310-abi3-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.10+Windows x86-64

glmm-0.1.3-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.3-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.3.tar.gz.

File metadata

  • Download URL: glmm-0.1.3.tar.gz
  • Upload date:
  • Size: 707.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.3.tar.gz
Algorithm Hash digest
SHA256 4cc65b1e22d3a2b9593078e1056d399a21585cbbdcf29caeb32dd44964ef8b3c
MD5 8c961dc99d936c250c982d1043b99a61
BLAKE2b-256 08ec477a2608bafdb1d92d7dd48f1beb393b67f2d349f5fac1acce4d9f63cc1e

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.3.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.3-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: glmm-0.1.3-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.3-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 6d44a56f371f526c367202032950498f582552df2cf0fa986cd38d721f0617bf
MD5 b674fef2f91da176df2b6c2d1be1fe16
BLAKE2b-256 4c80ca45413573e1f491458c8648f5206e32bdde93cfeb9d5c21e1fd9b860efa

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.3-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.3-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for glmm-0.1.3-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a93897ed7d55193524422d134deda549684bdbc2804a4e5af29abee9053c9cf0
MD5 bb14c4e47b868160cd3f99ea35c520f0
BLAKE2b-256 b3d0a874507e62eaf1b042c938c4cf92cfebf441e28215c4399c2f1f01d7214d

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.3-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.3-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

  • Download URL: glmm-0.1.3-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.3-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4ee718ee959ce5b9254befdd45c0a3f0d355e80cad4220c1160cdd09bc170fb8
MD5 01ea879e2bb0867bd93d6b6ea71716a6
BLAKE2b-256 e790ba37f6b28e7c454562619d889304f4f42fbf1c9ff0d2bf4e9ffcb1c45457

See more details on using hashes here.

Provenance

The following attestation bundles were made for glmm-0.1.3-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

This release

0.1.3 This release

4 files

0.1.2

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