Skip to main content

Hierarchical Pattern-aided Regression

Project description

Powered by Inria

HIPAR (Hierarchical Interpretable Pattern-aided Regression)

HIPAR is a pattern-based method for regression on tabular data. Given a dataset, HIPAR outputs a set of hybrid rules of the form p => y = f(X) that predict a target variable y. Here, p is a conjunctive pattern that characterizes a region of the dataset (e.g., property-type='house' and surface > 50), and f(X) is a linear function on the numerical features of the dataset.

How to use HIPAR

HIPAR's code is still in alpha status, nevertheless the code can be used without major issues.

from hipar import HIPAR
from data import get_simple_housing

hipar = HIPAR(min_support=2, interclass_variance_percentile_threshold=0)
X, y = get_simple_housing(), y)
## Get all rules found during the enumeration phase
## Get the rules selected by HiPaR (used for prediction)
X_test = ...

Experimental Results

The first implementation of HiPaR including all the experimental evaluation and data is available here.


Diferences with the published version

  • Interclass variance threshold is calculated over the entire set of refinement conditions and not on the set of discretized refinement conditions
  • We do not check if a new rule is better than all its parents, but only better than the generating parent. This just sents more rules to the selection phase, but makes the code simpler (I am not confident of the previous implementation of this feature).

Improvements w.r.t. the published version

  • Support for multiple metrics in the enumeration phase. A new rule will be compared against its parent on all the metrics provided as input in the constructor


  • Make a Python installable package [Urgent]
  • Consider other quality criteria to prune during the enumeration such as the p-values of the linear coefficients.
  • If we need to compare against all the HIPAR-based hybrid methods published in the paper, we will have to reimplement them.
  • Consider alternative discretization approaches for the numerical variables in the conditions.


  • Luis Galárraga, Olivier Pelgrin, Alexandre Termier. HiPaR: Hierarchical Pattern-aided Regression. Full paper at the Pacific-Asia Conference on Knowledge Discovery and Data Mining (PAKDD 2021), Delhi. [Technical Report]

Project details

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 Distribution

hipar-0.1.0-py3-none-any.whl (23.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page