error-parity 0.1.1

Achieve error-rate parity between protected groups for any predictor

error-parity

Fast postprocessing of any score-based predictor to meet fairness criteria.

The error-parity package can achieve strict or relaxed fairness constraint fulfillment, which can be useful to compare ML models at equal fairness levels.

Installing

Install package from PyPI:

pip install error-parity

Or, for development, you can clone the repo and install from local sources:

git clone https://github.com/AndreFCruz/error-parity.git
pip install ./error-parity

Getting started

from error_parity import RelaxedEqualOdds

# Given any trained model that outputs real-valued scores
fair_clf = RelaxedEqualOdds(
    predictor=lambda X: model.predict_proba(X)[:, -1],   # for sklearn API
    # predictor=model,  # use this for a callable model
    tolerance=0.05,     # fairness constraint tolerance
)

# Fit the fairness adjustment on some data
# This will find the optimal _fair classifier_
fair_clf.fit(X=X, y=y, group=group)

# Now you can use `fair_clf` as any other classifier
# You have to provide group information to compute fair predictions
y_pred_test = fair_clf(X=X_test, group=group_test)

How it works

Given a callable score-based predictor (i.e., y_pred = predictor(X)), and some (X, Y, S) data to fit, RelaxedEqualOdds will:

1. Compute group-specific ROC curves and their convex hulls;
2. Compute the r-relaxed optimal solution for the chosen fairness criterion (using cvxpy);
3. Find the set of group-specific binary classifiers that match the optimal solution found.
   • each group-specific classifier is made up of (possibly randomized) group-specific thresholds over the given predictor;
   • if a group's ROC point is in the interior of its ROC curve, partial randomization of its predictions may be necessary.

Implementation road-map

We welcome community contributions for cvxpy implementations of other fairness constraints.

Currently implemented fairness constraints:

• equality of odds (Hardt et al., 2016);
  • i.e., equal group-specific TPR and FPR;

Road-map:

• equal opportunity;
  • i.e., equal group-specific TPR;
• demographic parity;
  • i.e., equal group-specific predicted prevalence;