# ------------------------------------------------
# CITATION.cff file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# ------------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "Usmile" in publications use:'
type: software
license: MIT
title: 'Usmile: Threshold-Free Class-Specific Comparison of Binary Classifiers'
version: 0.2.0
identifiers:
- type: doi
  value: 10.32614/CRAN.package.Usmile
abstract: Implements the U-smile methodology for threshold-free, class-specific comparison
  of probabilistic binary classifiers. The package quantifies prediction improvement
  and worsening separately for non-events and events using the Brier alteration (BA),
  relative Brier (RB), improvement proportion (I) coefficients, and relative likelihood
  ratio (rLR) coefficients, and provides U-smile, prediction improvement-worsening,
  receiver operating characteristic, and precision-recall plots. The original U-smile
  framework is described in Kubiak et al. (2024) <https://doi.org/10.1371/journal.pone.0303276>,
  its three-level extension for imbalanced binary classification in Wieckowska et
  al. (2025) <https://doi.org/10.1371/journal.pone.0321661>, and the likelihood-based
  extension in Wieckowska and Guzik (2026) <https://doi.org/10.1038/s41598-026-40545-z>.
authors:
- family-names: Więckowska
  given-names: Barbara
  email: bbwieckowska@gmail.com
preferred-citation:
  type: manual
  title: 'Usmile (Universal Smile Layout for Explanation): Threshold-Free Class-Specific
    Comparison of Binary Classifiers'
  authors:
  - family-names: Wieckowska
    given-names: Barbara
  year: '2026'
  notes: R package version 0.2.0
repository: https://bbwieckowska.r-universe.dev
repository-code: https://github.com/bbwieckowska/Usmile
commit: ac0fe64bb42dc81f3112d698279e39b3a6274561
url: https://github.com/bbwieckowska/Usmile
date-released: '2026-08-02'
contact:
- family-names: Więckowska
  given-names: Barbara
  email: bbwieckowska@gmail.com
references:
- type: article
  title: 'Visualising and quantifying the usefulness of new predictors stratified
    by outcome class: The U-smile method'
  authors:
  - family-names: Kubiak
    given-names: Katarzyna B.
  - family-names: Wieckowska
    given-names: Barbara
  - family-names: Jodlowska-Siewert
    given-names: Elzbieta
  - family-names: Guzik
    given-names: Przemyslaw
  journal: PLOS ONE
  year: '2024'
  volume: '19'
  issue: '5'
  doi: 10.1371/journal.pone.0303276
  start: e0303276
- type: article
  title: Evaluating the three-level approach of the U-smile method for imbalanced
    binary classification
  authors:
  - family-names: Wieckowska
    given-names: Barbara
  - family-names: Kubiak
    given-names: Katarzyna B.
  - family-names: Guzik
    given-names: Przemyslaw
  journal: PLOS ONE
  year: '2025'
  volume: '20'
  issue: '4'
  doi: 10.1371/journal.pone.0321661
  start: e0321661
- type: article
  title: Usmile likelihood evaluation provides robust threshold free assessment of
    binary classification models for balanced and imbalanced datasets
  authors:
  - family-names: Wieckowska
    given-names: Barbara
  - family-names: Guzik
    given-names: Przemyslaw
  journal: Scientific Reports
  year: '2026'
  volume: '16'
  doi: 10.1038/s41598-026-40545-z
  start: '10000'