Metadata-Version: 2.1
Name: ruleminer
Version: 0.2.19
Summary: Python package to mine association rules in datasets
License: MIT/X
Keywords: association rules,pandas
Author: Willem Jan Willemse
Author-email: w.j.willemse@freedom.nl
Requires-Python: >=3.9,<3.13
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: Other/Proprietary License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pyparsing (>=3.0.0)
Requires-Dist: scikit-learn
Description-Content-Type: text/markdown

# ruleminer

[![Documentation](https://readthedocs.org/projects/ruleminer/badge)](https://ruleminer.readthedocs.io/en/latest/)
[![image](https://img.shields.io/pypi/v/ruleminer.svg)](https://pypi.python.org/pypi/ruleminer)
[![image](https://img.shields.io/pypi/pyversions/ruleminer.svg)](https://pypi.python.org/pypi/ruleminer)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Python package to discover association rules in Pandas DataFrames. 

This package implements the code of the paper [Discovering and ranking validation rules in supervisory data](https://github.com/wjwillemse/ruleminer/tree/main/docs/paper.pdf).
-   Free software: MIT/X license
-   Documentation: <https://ruleminer.readthedocs.io/en/latest>.

## Features

Here is what the package does:

* Generate human-readable validation rules using rule templates containing regular expressions and a Pandas DataFrame dataset

  - available functions: min, max, abs, quantile, sum, substr, split, count, sumif and countif
  - including parameters for metric filters and rule precisions (including XBRL tolerances)

* Evaluate rules and calculate association rules metrics

  - available metrics: abs support, abs exceptions, confidence, support, added value, casual confidence, casual support, conviction, lift and rule power factor

Here are some examples of rule templates with regexes with which you can generate validation rules:

  - *if ({"Type"} == ".*") then ({".*"} > 0)*

  - *if ({".*"} > 0) then (({".*"} == 0) & ({".*"} > 0))*

  - *(({".*"} + {".*"} + {".*"}) == {".*"})*

  - *({"Own funds"} <= quantile({"Own funds"}, 0.95))*

  - *(substr({"Type"}, 0, 1) in ["a", "b"])*

The first template generates (with the dataset described in the Usage section) rules like

  - *if ({"Type"} == "non-life_insurer") then ({"TP-nonlife"} > 0)*
  - *if ({"Type"} == "life_insurer") then ({"TP-life"} > 0)*

These generated validation rules can then be used to validate new datasets.

## Contributors

* Willem Jan Willemse <https://github.com/wjwillemse>

