Skip to main content

MLR-X is a cross-platform software package for multiple linear regression designed for low- and high-dimensional data, integrating model fitting, subset selection, validation, diagnostic analysis, and prediction into a unified workflow.

The software includes an implementation of EPR-C3, a reproducible heuristic search strategy based on Expand, Perturb, Reduce, and C3 refinement. This strategy explores the MLR model space while enforcing statistical admissibility constraints, including coefficient-significance thresholds, multicollinearity control, and pairwise-correlation filtering.

MLR-X provides a comprehensive set of internal and external validation metrics, applicability-domain assessment, and graphical diagnostics, enabling rigorous model evaluation and interpretation. Results are automatically compiled into structured, export-ready reports suitable for research and publication.

Install

pip install mlr-x

Run

Launch GUI mode:

mlrx

Run CLI mode:

mlrx <config.conf> 

Or

mlrx <config.conf> [--onlyIV]

Helpful parameters:

  • --version: show the version and exit.
  • --model: select a model identifier for requested outputs.
  • --outputs: define which outputs to generate (for example: diagnostics, visualization, summary).
  • pdf, png, tiff, and svg are export formats used for visualization outputs.
  • --noruns: use an existing results file from the configuration output path.
  • --onlyIV and --onlyEV: execute internal or external validation only, respectively, using models from an existing results file at the configured output path. Both options skip model search and require that the results file already exists.

Example:

python MLRX.py example.conf --model 1 --outputs summary

Requirements

  • Python 3.10+

On Linux, install GUI dependencies if needed:

sudo apt-get install python3-tk
sudo apt-get install xvfb

Prebuilt binaries

You can also download standalone binaries from the official release:

Available platforms:

  • Windows 10/11 (64-bit)
  • macOS X (Arm64)
  • Ubuntu 20.04 (x86-64)

How to cite

Article under review. For now, please cite as follows:

Release files for mlr-x 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mlr-x 1.0.4
File Size Uploaded
mlr_x-1.0.4.tar.gz 240.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mlr-x 1.0.4
File Interpreter ABI Platform
mlr_x-1.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 484.1 kB

Release files / mlr_x-1.0.4.tar.gz

Download URL mlr_x-1.0.4.tar.gz
Size 240.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c4602ea81eced23e6ea30016fc0bf5dc31aa852110d1ba25ff562783e3304279
BLAKE2b-256 checksum
How to use checksums
581a0ceac6a0a47e2626c24efa28af3e6088a1e27668dda68e2ec88e6cb1d656
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.20

Release files / mlr_x-1.0.4-py3-none-any.whl

Download URL mlr_x-1.0.4-py3-none-any.whl
Size 243.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a91539b21fea4a6daee8706e841e5a0063df28e024803d7cbe9abc3c29646d23
BLAKE2b-256 checksum
How to use checksums
faad94bd9494e8dd01bb48c4fcfef9c3d88afec193185ca40bed005b17bbaa7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.20

Release history Release notifications | RSS feed

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

This release

1.0.4 This release

2 release files

1.0.3

2 release 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