# ------------------------------------------------
# CITATION.cff file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# ------------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "phontrast" in publications use:'
type: software
license: MIT
title: 'phontrast: Contrast and Separation Metrics for Phonological Categories'
version: 2.5.1
doi: 10.5281/zenodo.23227434
identifiers:
- type: doi
  value: 10.32614/CRAN.package.phontrast
abstract: Computes and compares multiple measures of separation and overlap between
  phonological categories (for example vowels or consonants) in arbitrary multi-dimensional
  acoustic spaces such as formant values, mel-frequency cepstral coefficients (MFCCs),
  duration, or learned embeddings. The main entry point, phontrast(), reports several
  contrast metrics in one call -- Jensen-Shannon divergence and distance (Lin, 1991)
  <https://doi.org/10.1109/18.61115>, the Pillai-Bartlett trace, Bhattacharyya distance
  and affinity, Mahalanobis distance, and proportional overlap -- globally or by group
  on a common separation-oriented scale, with bootstrap confidence intervals. rank_contrasts()
  implements a measurement protocol for ranking speakers' contrasts by Jensen-Shannon
  distance and checking the ranking against Pillai, with sample-size licensing and
  a bandwidth-sensitivity check. Also provides utilities for preparing estimates for
  downstream modelling such as generalized additive models and mixed-effects models.
  Formerly released as 'phonJSD'.
authors:
- family-names: Berry
  given-names: Grant M.
  email: berry.grant@gmail.com
preferred-citation:
  type: generic
  title: 'phontrast: Contrast and Separation Metrics for Phonological Categories'
  authors:
  - family-names: Berry
    given-names: Grant M.
    email: berry.grant@gmail.com
  year: '2026'
  publisher:
    name: Zenodo
  version: 2.5.1
  doi: 10.5281/zenodo.23227434
  url: https://doi.org/10.5281/zenodo.23227434
  notes: R package version 2.5.1
repository: https://berrygrant.r-universe.dev
repository-code: https://github.com/berrygrant/phontrast
commit: 300c01682fc2d3667932a1b9ed60ff454221c52a
url: https://github.com/berrygrant/phontrast
date-released: '2026-10-08'
contact:
- family-names: Berry
  given-names: Grant M.
  email: berry.grant@gmail.com
references:
- type: unpublished
  title: Estimand or estimator? Comparing vowel overlap measures against a known ground
    truth
  authors:
  - family-names: Berry
    given-names: Grant M.
  year: '2026'
  notes: 'Manuscript under review, Journal of the Acoustical Society of America (JASA-14548R1).
    Replication package: https://osf.io/t2wsj'
  url: https://osf.io/t2wsj