To cite the Usmile package and methodology, use the following references:

Wieckowska B (2026). Usmile (Universal Smile Layout for Explanation): Threshold-Free Class-Specific Comparison of Binary Classifiers. R package version 0.2.0.

Kubiak KB, Wieckowska B, Jodlowska-Siewert E, Guzik P (2024). “Visualising and quantifying the usefulness of new predictors stratified by outcome class: The U-smile method.” PLOS ONE, 19(5), e0303276. doi:10.1371/journal.pone.0303276.

Wieckowska B, Kubiak KB, Guzik P (2025). “Evaluating the three-level approach of the U-smile method for imbalanced binary classification.” PLOS ONE, 20(4), e0321661. doi:10.1371/journal.pone.0321661.

Wieckowska B, Guzik P (2026). “Usmile likelihood evaluation provides robust threshold free assessment of binary classification models for balanced and imbalanced datasets.” Scientific Reports, 16, 10000. doi:10.1038/s41598-026-40545-z.

Please cite both the package and the publication describing the methodological component used.

Corresponding BibTeX entries:

  @Manual{,
    title = {Usmile (Universal Smile Layout for Explanation):
      Threshold-Free Class-Specific Comparison of Binary Classifiers},
    author = {Barbara Wieckowska},
    year = {2026},
    note = {R package version 0.2.0},
  }

  @Article{,
    title = {Visualising and quantifying the usefulness of new
      predictors stratified by outcome class: The U-smile method},
    author = {Katarzyna B. Kubiak and Barbara Wieckowska and Elzbieta
      Jodlowska-Siewert and Przemyslaw Guzik},
    journal = {PLOS ONE},
    year = {2024},
    volume = {19},
    number = {5},
    pages = {e0303276},
    doi = {10.1371/journal.pone.0303276},
  }

  @Article{,
    title = {Evaluating the three-level approach of the U-smile method
      for imbalanced binary classification},
    author = {Barbara Wieckowska and Katarzyna B. Kubiak and Przemyslaw
      Guzik},
    journal = {PLOS ONE},
    year = {2025},
    volume = {20},
    number = {4},
    pages = {e0321661},
    doi = {10.1371/journal.pone.0321661},
  }

  @Article{,
    title = {Usmile likelihood evaluation provides robust threshold
      free assessment of binary classification models for balanced and
      imbalanced datasets},
    author = {Barbara Wieckowska and Przemyslaw Guzik},
    journal = {Scientific Reports},
    year = {2026},
    volume = {16},
    pages = {10000},
    doi = {10.1038/s41598-026-40545-z},
  }