# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "fairmetrics" in publications use:'
type: software
license: MIT
title: 'fairmetrics: Fairness Evaluation Metrics with Confidence Intervals for Binary
  Protected Attributes'
version: 1.0.8
doi: 10.21105/joss.08497
identifiers:
- type: doi
  value: 10.32614/CRAN.package.fairmetrics
abstract: A collection of functions for computing fairness metrics for machine learning
  and statistical models, including confidence intervals for each metric. The package
  supports the evaluation of group-level fairness criterion commonly used in fairness
  research, particularly in healthcare for binary protected attributes. It is based
  on the overview of fairness in machine learning written by Gao et al (2025) <https://doi.org/10.1002/sim.70234>.
authors:
- family-names: Gao
  given-names: Jianhui
  email: jianhui.gao@mail.utoronto.ca
  orcid: https://orcid.org/0000-0003-0915-1473
- family-names: Smith
  given-names: Benjamin
  email: benyamin.smith@mail.utoronto.ca
  orcid: https://orcid.org/0009-0007-2206-0177
- family-names: Chou
  given-names: Benson
  email: benson.chou@mail.utoronto.ca
  orcid: https://orcid.org/0009-0007-0265-033X
- family-names: Gronsbell
  given-names: Jessica
  email: j.gronsbell@utoronto.ca
  orcid: https://orcid.org/0000-0002-5360-5869
preferred-citation:
  type: article
  title: 'fairmetrics: An R package for group fairness evaluation'
  authors:
  - family-names: Smith
    given-names: Benjamin
    email: benyamin.smith@mail.utoronto.ca
    orcid: https://orcid.org/0009-0007-2206-0177
  - family-names: Gao
    given-names: Jianhui
    email: jianhui.gao@mail.utoronto.ca
    orcid: https://orcid.org/0000-0003-0915-1473
  - family-names: Chou
    given-names: Benson
    email: benson.chou@mail.utoronto.ca
    orcid: https://orcid.org/0009-0007-0265-033X
  - family-names: Gronsbell
    given-names: Jessica
    email: j.gronsbell@utoronto.ca
    orcid: https://orcid.org/0000-0002-5360-5869
  year: '2025'
  journal: Journal of Open Source Software
  volume: '10'
  issue: '113'
  doi: 10.21105/joss.08497
  url: https://doi.org/10.21105/joss.08497
  publisher:
    name: The Open Journal
  start: '8497'
repository: https://jianhuig.r-universe.dev
commit: e32f070bd668acef95c98c193c43ece3873e4105
url: https://jianhuig.github.io/fairmetrics/
date-released: '2026-04-17'
contact:
- family-names: Smith
  given-names: Benjamin
  email: benyamin.smith@mail.utoronto.ca
  orcid: https://orcid.org/0009-0007-2206-0177
references:
- type: manual
  title: 'fairmetrics: Fairness Evaluation Metrics with Confidence Intervals for Binary
    Protected Attributes'
  authors:
  - family-names: Gao
    given-names: Jianhui
  - family-names: Smith
    given-names: Benjamin
  - family-names: Chou
    given-names: Benson
  - family-names: Gronsbell
    given-names: Jessica
  year: '2025'
  url: https://github.com/jianhuig/fairmetrics
- type: article
  title: What Is Fair? Defining Fairness in Machine Learning for Health
  authors:
  - family-names: Gao
    given-names: Jianhui
  - family-names: Chou
    given-names: Benson
  - family-names: McCaw
    given-names: Zachary R.
  - family-names: Thurston
    given-names: Hilary
  - family-names: Varghese
    given-names: Paul
  - family-names: Hong
    given-names: Chuan
  - family-names: Gronsbell
    given-names: Jessica
  journal: Statistics in Medicine
  year: '2025'
  volume: '44'
  issue: 20-22
  doi: 10.1002/sim.70234
  url: https://onlinelibrary.wiley.com/doi/abs/10.1002/sim.70234
  start: e70234