"MLRL-Common": Building-Blocks for Multi-Output Rule Learning Algorithms

This software package provides common modules to be used by different types of multi-output rule learning (MLRL) algorithms that integrate with the popular scikit-learn machine learning framework.

The problem domains addressed by this software include the following:

Multi-label classification: The goal of multi-label classification is the automatic assignment of sets of labels to individual data points, for example, the annotation of text documents with topics.
Multi-output regression: Multivariate regression problems require to predict for more than a single numerical output variable.

The library serves as the basis for the implementation of the following rule learning algorithms:

BOOMER (Gradient Boosted Multi-Output Rules): A state-of-the art algorithm that uses gradient boosting to learn an ensemble of rules that is built with respect to a given multivariate loss function.
Multi-label Separate-and-Conquer (SeCo) Rule Learning Algorithm: A heuristic rule learning algorithm based on traditional rule learning techniques that are particularly well-suited for learning interpretable models.

:wrench: Functionalities

This package follows a unified and modular framework for the implementation of different types of rule learning algorithms. In the following, we provide an overview of the individual modules an instantiation of the framework must implement.

Rule Induction

A module for rule induction that is responsible for the construction of individual rules. Currently, the following modules of this kind are implemented:

A module for greedy rule induction that conducts a top-down search, where rules are constructed by adding one condition after the other and adjusting its prediction accordingly.
Rule induction based on a beam search, where a top-down search is conducted as described above. However, instead of focusing on the best solution at each step, the algorithm keeps track of a predefined number of promising solutions and picks the best one at the end.

All of the above modules support numerical, ordinal, and nominal features and can handle missing feature values. They can also be combined with methods for unsupervised feature binning, where training examples with similar features values are assigned to bins in order to reduce the training complexity. Moreover, multi-threading can be used to speed up training.

Model Assemblage

A module for the assemblage of a rule model that consists of several rules. Currently, the following strategies can be used for constructing a model:

Sequential assemblage of rule models, where one rule is learned after the other.

Sampling Methods

A wide variety of sampling methods, including sampling with and without replacement, as well as stratified sampling techniques, is provided by this package. They can be used to learn new rules on a subset of the available training examples, features, or labels.

(Output Space) Statistics

So-called output space statistics serve as the basis for assessing the quality of potential rules and determining their predictions. The notion of the statistics heavily depend on the rule learning algorithm at hand. For this reason, no particular implementation is currently included in this package.

Post-Processing

Post-processing methods can be used to alter the predictions of a rule after it has been learned. Whether this is desirable or not heavily depends on the rule learning algorithm at hand. For this reason, no post-processing methods are currently provided by this package.

Pruning Methods

Rule pruning techniques can optionally be applied to a rule after its construction to improve its generalization to unseen data and prevent overfitting. The following pruning techniques are currently supported by this package:

Incremental reduced error pruning (IREP) removes overly specific conditions from a rule if this results in an increase of predictive performance (measured on a holdout set of the training data).

Stopping Criteria

One or several stopping criteria can be used to decide whether additional rules should be added to a model or not. Currently, the following criteria are provided out-of-the-box:

A size-based stopping criterion that ensures that a certain number of rules is not exceeded.
A time-based stopping criterion that stops training as soon as a predefined runtime was exceeded.
Pre-pruning (a.k.a. early stopping) aims at terminating the training process as soon as the performance of a model stagnates or declines (measured on a holdout set of the training data).

Post-Optimization

Post-optimization methods can be employed to further improve the predictive performance of a model after it has been assembled. Currently, the following post-optimization techniques can be used:

Sequential post-optimization reconstructs each rule in a model in the context of the other rules.
Post-pruning may remove trailing rules from a model in this increases the models performance (as measured on a holdout set of the training data).

Prediction algorithm

A prediction algorithm is needed to derive predictions from the rules in a previously assembled model. As prediction methods heavily depend on the rule learning algorithm and problem domain at hand, no implementation is provided by this package out-of-the-box. However, it defines interfaces for the prediction of scores, binary predictions, or probability estimates.

:scroll: License

This project is open source software licensed under the terms of the MIT license. We welcome contributions to the project to enhance its functionality and make it more accessible to a broader audience. A frequently updated list of contributors is available here.

All contributions to the project and discussions on the issue tracker are expected to follow the code of conduct.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mlrl_common-0.15.5-cp314-cp314t-musllinux_1_2_x86_64.whl (4.5 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmusllinux: musl 1.2+ x86-64

mlrl_common-0.15.5-cp314-cp314t-musllinux_1_2_aarch64.whl (4.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmusllinux: musl 1.2+ ARM64

mlrl_common-0.15.5-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (3.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mlrl_common-0.15.5-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (3.2 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmanylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

mlrl_common-0.15.5-cp314-cp314t-macosx_11_0_arm64.whl (2.5 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmacOS 11.0+ ARM64

mlrl_common-0.15.5-cp314-cp314t-macosx_10_15_x86_64.whl (2.8 MB view details)

Uploaded Aug 26, 2026 CPython 3.14tmacOS 10.15+ x86-64

mlrl_common-0.15.5-cp314-cp314-win_arm64.whl (1.9 MB view details)

Uploaded Aug 26, 2026 CPython 3.14Windows ARM64

mlrl_common-0.15.5-cp314-cp314-win_amd64.whl (1.9 MB view details)

Uploaded Aug 26, 2026 CPython 3.14Windows x86-64

mlrl_common-0.15.5-cp314-cp314-musllinux_1_2_x86_64.whl (4.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

mlrl_common-0.15.5-cp314-cp314-musllinux_1_2_aarch64.whl (4.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.14musllinux: musl 1.2+ ARM64

mlrl_common-0.15.5-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (3.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.14manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mlrl_common-0.15.5-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (3.2 MB view details)

Uploaded Aug 26, 2026 CPython 3.14manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

mlrl_common-0.15.5-cp314-cp314-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.14macOS 11.0+ ARM64

mlrl_common-0.15.5-cp314-cp314-macosx_10_15_x86_64.whl (2.6 MB view details)

Uploaded Aug 26, 2026 CPython 3.14macOS 10.15+ x86-64

mlrl_common-0.15.5-cp313-cp313-win_arm64.whl (1.8 MB view details)

Uploaded Aug 26, 2026 CPython 3.13Windows ARM64

mlrl_common-0.15.5-cp313-cp313-win_amd64.whl (1.8 MB view details)

Uploaded Aug 26, 2026 CPython 3.13Windows x86-64

mlrl_common-0.15.5-cp313-cp313-musllinux_1_2_x86_64.whl (4.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

mlrl_common-0.15.5-cp313-cp313-musllinux_1_2_aarch64.whl (4.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.13musllinux: musl 1.2+ ARM64

mlrl_common-0.15.5-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (3.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.13manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mlrl_common-0.15.5-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (3.2 MB view details)

Uploaded Aug 26, 2026 CPython 3.13manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

mlrl_common-0.15.5-cp313-cp313-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.13macOS 11.0+ ARM64

mlrl_common-0.15.5-cp313-cp313-macosx_10_13_x86_64.whl (2.6 MB view details)

Uploaded Aug 26, 2026 CPython 3.13macOS 10.13+ x86-64

mlrl_common-0.15.5-cp312-cp312-win_arm64.whl (1.8 MB view details)

Uploaded Aug 26, 2026 CPython 3.12Windows ARM64

mlrl_common-0.15.5-cp312-cp312-win_amd64.whl (1.8 MB view details)

Uploaded Aug 26, 2026 CPython 3.12Windows x86-64

mlrl_common-0.15.5-cp312-cp312-musllinux_1_2_x86_64.whl (4.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

mlrl_common-0.15.5-cp312-cp312-musllinux_1_2_aarch64.whl (4.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

mlrl_common-0.15.5-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (3.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.12manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

mlrl_common-0.15.5-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (3.2 MB view details)

Uploaded Aug 26, 2026 CPython 3.12manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

mlrl_common-0.15.5-cp312-cp312-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.12macOS 11.0+ ARM64

mlrl_common-0.15.5-cp312-cp312-macosx_10_13_x86_64.whl (2.6 MB view details)

Uploaded Aug 26, 2026 CPython 3.12macOS 10.13+ x86-64

File details

Details for the file mlrl_common-0.15.5-cp314-cp314t-musllinux_1_2_x86_64.whl.

File metadata

Download URL: mlrl_common-0.15.5-cp314-cp314t-musllinux_1_2_x86_64.whl
Upload date: Aug 26, 2026
Size: 4.5 MB
Tags: CPython 3.14t, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mlrl_common-0.15.5-cp314-cp314t-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`58ada790358b91f33c7c3e937c6b68c404170259a13805d3ecf00f53da410e1a`
MD5	`79d28ca326aa431280c7b380d3513873`
BLAKE2b-256	`65a43e375272a661639ded2a6e9f72d61fcffcd139382b313b8197363cf37b0b`

Algorithm	Hash digest
SHA256	`4b864917c2d789b0c0bb2995f9ce256fb1aa38af2fcb0da423e47ee39674d971`
MD5	`3661ba5ab2e6d19f9946e28d9a57de77`
BLAKE2b-256	`c246a22bc8a5d9445c30d288cda846eca9ba4ee859ac9c926c0f850ad1d00de7`

Algorithm	Hash digest
SHA256	`b999cdd4f05184e4f940fb7139738e3f2fbcaec40a6fdd9b5987a142e75658f8`
MD5	`efabff0f8120aa5c20a9c94b0296b223`
BLAKE2b-256	`8966956e638d804a26d809ea3e4fb84c1a4037d9e76489af95011fe129d4e1ae`

Algorithm	Hash digest
SHA256	`23f78a56bda3aec04ddfef983fdd7a424ed39a2d7e48b491811ddb7fd8659903`
MD5	`1edf965caa0874f445b31cac4c563d71`
BLAKE2b-256	`62713748fb6c600c7ad3c0356b51fccb22a7e19b78b1f81874075bb40821aa5a`

Algorithm	Hash digest
SHA256	`6c806ecc18a6eed2b7df308759503fdeee058200dfea8e5575898260591a4dea`
MD5	`d204ae66028cde7522625a3399474ed2`
BLAKE2b-256	`180794ea11c98f20ded3c0e41d5c1981c65e9c630b448c73b78405c36d2efe6a`

Algorithm	Hash digest
SHA256	`c1203ca325f7760ac30831bd378d7fd6c7227724f46f9eda72bffe3e87a2c9c8`
MD5	`d0d6b63ddc1c48d4272b7a46d78ab46e`
BLAKE2b-256	`e77667a630d67ad3a73b0b4882d16421b5b314c9f03933c91936e7898b49162a`

Algorithm	Hash digest
SHA256	`4256025795bf694957317af776e724e77bb670503e7e58bc11afc2dc75317ca7`
MD5	`5f73b0db73fed7f1e5b452c1e58eedb2`
BLAKE2b-256	`0e5360ba4b4503af798d8527af648821d10f281bbb4cdf642a526a3bf9f641f1`

Algorithm	Hash digest
SHA256	`48bec9932c202343bd83975002cbcfa3806ce6615afb939c35608bce41ecbc76`
MD5	`7f762819b316184e70e995712ea27a47`
BLAKE2b-256	`49750ddab4910fe3f829bbca1180d2a4e493672955268dce9095a30c7207ccbd`

Algorithm	Hash digest
SHA256	`bc50c9ad95f5a5415b6e0b0cd90afa9f188873e3286ad69f7b97f30782e03188`
MD5	`8dfe40c2f9eb56baebd17fa18ec259cc`
BLAKE2b-256	`7a709f001acfdcebf2c97043af651144fa1ea3bdd5cdc1b31c702d06a23f8694`

Algorithm	Hash digest
SHA256	`6c14b7d1f987795293277eaa70bf5bf6080dd7986ae13a8061d438504d554344`
MD5	`9e3ed776b3d704f0a2b56a74e257781d`
BLAKE2b-256	`b3efffd2e1e45d033d9dcdcb60762d83481df2fbc0aea4ac0f1110e02a8ba148`

Algorithm	Hash digest
SHA256	`d799330ffd89108a058d40f7839e7e333438e344b83dfa903e64d19ea9ff3012`
MD5	`7d864ddee652b26bb899d386b6594ddd`
BLAKE2b-256	`a328ce4e0a4fdd35e5b5727f1d618f74db23850524064e9610daec3658d30c0c`

Algorithm	Hash digest
SHA256	`eae2d36b83b270599717d96b63b2d1f6d47bb6b54f7751f6420a4436a728ea66`
MD5	`9623f3fe0b3adb9a1d5081b7f472f48a`
BLAKE2b-256	`7f222166938d498483d47a8dd818be7f17837545fe533f5ce895e78b7c26f478`

Algorithm	Hash digest
SHA256	`d75fc0e179c14d9de3d6ab180f6cf1b71858cfdd72eb3875ecc4d938cc8086f6`
MD5	`35b939b689fc59cba2a5128de2f5af11`
BLAKE2b-256	`2eb85d863b655a952c4aee4f2068deab8c20ead8f477d15153ff8ae0f9430a41`

Algorithm	Hash digest
SHA256	`c7ca06788ecd50f55f8068d1b5ff7a377bfdb43f61a70ef76eeca077667c219e`
MD5	`f74b8db071af620856cee396878b0ca0`
BLAKE2b-256	`17500c187bbf638b5f33c385c919b882887223d6d3320f98cbe3c46ba245d29f`

Algorithm	Hash digest
SHA256	`f61966ab0904e842b7216d3cd96a78c3011ed9e2d7ad7aa3949dd231175eb500`
MD5	`93078888667c5f87e0586645aea43bfd`
BLAKE2b-256	`9782a16f86be82e2baaeaf8699a807295c6f65f8c22fa9a6636838f20819d834`

Algorithm	Hash digest
SHA256	`ede836f35a69c58d6f9f526cb5a32924f10739c0c8669b3d142913ef8876aff6`
MD5	`ea5de96b3e8d5b5a419ceae548207c42`
BLAKE2b-256	`8cf086d3da34ad219a4047a8df1d749fcd227b33354b2e3fafc1555d0a135616`

Algorithm	Hash digest
SHA256	`c652e3f6f50a4706dc91185c10339a38b0103a0945b9875c63e6dc139ed8a485`
MD5	`f1a592dd6bd9a31d8dd031a64ab357ab`
BLAKE2b-256	`11402da469d99c1bb152cc1d9d365da602f7323d28eb26ae25d6c86451843d44`

Algorithm	Hash digest
SHA256	`ba3a6d9a0147474a0cb7be7a1ea35f2d3d355c24640e1b8eda65a5302ce85a43`
MD5	`5adbdacb87a6fb66bb5a357a58d428d5`
BLAKE2b-256	`a8d5ff911f5a385cafe23b5ad932286b8b5ea90c3b958d9fd4a8aada3f0ec935`

Algorithm	Hash digest
SHA256	`08f8cbf04871941eaafb2ee13e079ff25e2d802ab611fd3b2abeceeaa14b5b67`
MD5	`1cd2b8805b33d26735618c318ada4bb4`
BLAKE2b-256	`51f6f9fa314a45daf04dd7436b16fb00aa50ce248db59ae06e980a4cd188823d`

Algorithm	Hash digest
SHA256	`84c07a271d51c4e3a2cc54b3a58611db0d129699a84816d73d619669d902f10f`
MD5	`b5fbbe0ed7773c028e708b0a61d46714`
BLAKE2b-256	`55afcbe7f01c610fd298610499ec8574d831691a9d5a8066cb248e7c4fe97783`

Algorithm	Hash digest
SHA256	`38c97f201ca1babfc4a9105b519db96345e9033641d6531bccfe200cefbed8ca`
MD5	`b2e92252b80f9d3acb1c78ade2f954a7`
BLAKE2b-256	`6119eb8058dd8329be783f32399c95befb52080219d7998b386d4fe467db3afc`

mlrl-common 0.15.5

"MLRL-Common": Building-Blocks for Multi-Output Rule Learning Algorithms

:wrench: Functionalities

Rule Induction

Model Assemblage

Sampling Methods

(Output Space) Statistics

Post-Processing

Pruning Methods

Stopping Criteria

Post-Optimization

Prediction algorithm

:scroll: License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

Algorithm	Hash digest
SHA256	`2a129ebeccf9510fba3cdec0f0e350d9c91758417c4abf370a88c1197c53a92b`
MD5	`ebe66866f91efc6bb70a875aa9b7d4d1`
BLAKE2b-256	`f34cb54f7f4a20511fda60eeb51487bffb1509fb62b7d467e2da9a709d0af80e`

Algorithm	Hash digest
SHA256	`cc116a81e1a19ef86292aac45028e75131dfc269531eb3e0730ad7e3b8865165`
MD5	`cffd5a63e2060e5e340091574257421e`
BLAKE2b-256	`5166874d739cb8a7f2e7acad73dc065d0a1c64d4fe353d2c085d7b60b9688d89`

Algorithm	Hash digest
SHA256	`b21efb260c87d8bb1f8d19752c46f5979beaab601d48b3398dd5c84cd9f3ff18`
MD5	`de0698bf91a7ce2d57b81911d8dc5519`
BLAKE2b-256	`8098aeba16cb066ac199b2514e87b288e1398a10ce7eb0ad1d5f768a958a4202`

Algorithm	Hash digest
SHA256	`3eeca4766ab28252ce707f077134a70e5844d70471b1ca3a7727d48ce42aae04`
MD5	`fb18368d15c10e2ea0a6625200a4ffc7`
BLAKE2b-256	`bc204f8acef621bcf466c9e338d8d3f430cabaa7edf049b3f1c67c1c3e6ac5d2`

Algorithm	Hash digest
SHA256	`d7442dd461783f1cc13c6cb93e75a9a6459d6c3fbc965bec27b6ae736f90b97d`
MD5	`96170cdb3910d6dcbc1742e348b94f13`
BLAKE2b-256	`b35fc5b6cef60f34aba20aa3e2c628000ff43df3e2fe125083abe78654c0bb9c`

Algorithm	Hash digest
SHA256	`e1016ee959e9ca60730fa7dd0c1070dcb4adc1bbb9d8e7bb1a36ccde270d4525`
MD5	`3a9bbeae2cdc7074d3932ef0ae3cf001`
BLAKE2b-256	`b6530bb65fe60672063445b387331089e2d87a126f86dc70fe1ce0777e0f4535`

Algorithm	Hash digest
SHA256	`972b1e76226ef76a722b7f2edae62a612774d69ed4e558de04cf0878796a72ff`
MD5	`d6f4768c5bcf2428bae4bcad9d5f4fae`
BLAKE2b-256	`4928432fecb6bd7d110fbec0a2e22314063fbae642ace7c43d2a945c4cd7ef58`

Algorithm	Hash digest
SHA256	`dfa8c4f859f18a06d1fca597651defe5381a8ba297821087f244735b12bcde81`
MD5	`9632932755e0c6d0ebd0e36f8449daee`
BLAKE2b-256	`50d121c4dd29212ed8545d5a10eabae97ba29fcfc1a3747235a143abd572579e`

Algorithm	Hash digest
SHA256	`2c757b6f6fd47c0b75d15c04243f0eb8fb1b9ab70ce14210d1ff4950b204e71c`
MD5	`03e1f2edb6b392e86cbcda543829a129`
BLAKE2b-256	`987340aa062598ab4334b7dda507fde6438d7aa26a9bdce3db3184c3118442e4`