Skip to content

Code implementing differential fairness (DF) metric in: J. R. Foulds, R. Islam, K. Keya, and S. Pan. An Intersectional Definition of Fairness. 36th IEEE International Conference on Data Engineering (ICDE), 2020

License

Notifications You must be signed in to change notification settings

rashid-islam/Differential_Fairness

Repository files navigation

Differential Fairness

Code implementing differential fairness (DF) metric with demonstrations on the Adult 1994 U.S. census income data from the UCI repository

Prerequisites

  • Python
  • PyTorch

The code is tested on windows and linux operating systems. It should work on any other platform.

Differential fairness (DF) measurement

  • differential_fairness.py: Python code implements function for DF using empirical counts with Dirichlet smoothing
  • demo_all_groups.py: Demo for measurement of DF on all intersectional groups in Adult dataset
  • demo_binary_groups.py: Demo for measurement of DF on intersectional groups in Adult dataset while each protected attribute (i.e. race) can only have binary values (i.e. white and non-white)
  • 'data' folder contains the Adult dataset

Learning algorithms

  • We provide "easy to understand" implementation of learning algorithms for batch and stochastic methods. Detail instructions to run batch DF and stochastic DF classifiers are provided in the "learning-algorithm-batch" and "learning-algorithm-stochastic" folders, respectively.

Author

License

The code to implement differential fairness metric is licensed under Apache License Version 2.0.

Acknowledgments

Many part of the Adult data pre-processing was based on the "Towards fairness in machine learning with adversarial networks" blog post.

Remarks

Code for calculating our differential fairness metric is now available in the AI Fairness 360 toolkit from IBM Research! AI Fairness 360 Open Source Toolkit.

Reference Papers

  • Please cite the corresponding paper when using the code
  1. R. Islam, K.N. Keya, S. Pan, A.D. Sarwate, and J.R. Foulds. Differential fairness. Under submission, 2021.
  2. J. R. Foulds, R. Islam, K. Keya, and S. Pan. An Intersectional Definition of Fairness. 36th IEEE International Conference on Data Engineering (ICDE), 2020. Arxiv long version.
  3. J. R. Foulds, R. Islam, K. Keya, and S. Pan. Differential fairness. NeurIPS 2019 Workshop on Machine Learning with Guarantees, 2019. PDF.

About

Code implementing differential fairness (DF) metric in: J. R. Foulds, R. Islam, K. Keya, and S. Pan. An Intersectional Definition of Fairness. 36th IEEE International Conference on Data Engineering (ICDE), 2020

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages