{ "_id": "6ac76769de46216d5edcf767", "Package": "phontrast", "Title": "Contrast and Separation Metrics for Phonological Categories", "Version": "2.5.1", "Authors@R": "person(c(\"Grant\", \"M.\"), \"Berry\", email = \"berry.grant@gmail.com\",\nrole = c(\"aut\", \"cre\"))", "Author": "Grant M. Berry [aut, cre]", "Maintainer": "Grant M. Berry ", "Description": "Computes and compares multiple measures of separation and\noverlap between phonological categories (for example vowels or\nconsonants) in arbitrary multi-dimensional acoustic spaces such\nas formant values, mel-frequency cepstral coefficients (MFCCs),\nduration, or learned embeddings. The main entry point,\nphontrast(), reports several contrast metrics in one call --\nJensen-Shannon divergence and distance (Lin, 1991)\n, the Pillai-Bartlett trace,\nBhattacharyya distance and affinity, Mahalanobis distance, and\nproportional overlap -- globally or by group on a common\nseparation-oriented scale, with bootstrap confidence intervals.\nrank_contrasts() implements a measurement protocol for ranking\nspeakers' contrasts by Jensen-Shannon distance and checking the\nranking against Pillai, with sample-size licensing and a\nbandwidth-sensitivity check. Also provides utilities for\npreparing estimates for downstream modelling such as\ngeneralized additive models and mixed-effects models. Formerly\nreleased as 'phonJSD'.", "License": "MIT + file LICENSE", "URL": "https://github.com/berrygrant/phontrast", "BugReports": "https://github.com/berrygrant/phontrast/issues", "Encoding": "UTF-8", "LazyData": "true", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.3", "Config/testthat/edition": "3", "VignetteBuilder": "knitr", "Repository": "https://berrygrant.r-universe.dev", "Date/Publication": "2026-10-08 02:45:16 UTC", "RemoteUrl": "https://github.com/berrygrant/phontrast", "RemoteRef": "HEAD", "RemoteSha": "300c01682fc2d3667932a1b9ed60ff454221c52a", "NeedsCompilation": "no", "Packaged": { "Date": "2026-10-08 09:19:35 UTC", "User": "root" }, "_user": "berrygrant", "_type": "src", "_file": "phontrast_2.5.1.tar.gz", "_fileid": "https://r2.ropensci.org/8ec44103de54f3534aa4a9d0dc8c67d7e573b953a0c4aac92a5167d4224631ce", "_filesize": 1457582, "_sha256": "8ec44103de54f3534aa4a9d0dc8c67d7e573b953a0c4aac92a5167d4224631ce", "_expires": "2027-01-16T09:50:31.000Z", "_created": "2026-10-08T09:19:35.000Z", "_published": "2026-10-08T09:50:33.636Z", "_buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811", "_status": "success", "_host": "GitHub-Actions", "_jobs": [ { "job": 113240280405, "time": 269, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11539818881" }, { "job": 113240280385, "time": 190, "config": "linux-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11540082959" }, { "job": 113240280395, "time": 207, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "11541547153" }, { "job": 113240280418, "time": 172, "config": "macos-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "11541412737" }, { "job": 113239107966, "time": 181, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "11539923604" }, { "job": 113240280316, "time": 99, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "11540320851" }, { "job": 113240280506, "time": 213, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11539968826" }, { "job": 113240280386, "time": 185, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "11540315680" }, { "job": 113240280486, "time": 201, "config": "windows-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11540715162" } ], "_upstream": "https://github.com/berrygrant/phontrast", "_commit": { "id": "300c01682fc2d3667932a1b9ed60ff454221c52a", "author": "Grant M. Berry ", "committer": "Grant M. Berry ", "message": "Record the Zenodo DOI of phontrast 2.5.1 (10.5281/zenodo.23227434)\n\nWritten by dev/release.py doi: inst/CITATION version map, test-citation.R,\nand CITATION.cff (doi and url; the concept DOI is kept under identifiers).\n\nCo-Authored-By: Claude Opus 5.5 \nClaude-Session: https://claude.ai/code/session_01AVbdNo9SfA7LEGt7RGB2Jo\n", "time": 1791427516 }, "_maintainer": { "name": "Grant M. Berry", "email": "berry.grant@gmail.com", "login": "berrygrant", "description": "Language. Cognition. Computation.\nAssistant Professor building reproducible tools for speech and brain research.", "uuid": 13824930 }, "_distro": "resolute", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.1.0", "role": "Depends" }, { "package": "ks", "role": "Imports" }, { "package": "dplyr", "role": "Imports" }, { "package": "purrr", "role": "Imports" }, { "package": "tibble", "role": "Imports" }, { "package": "rlang", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "grDevices", "role": "Imports" }, { "package": "utils", "role": "Imports" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "mgcv", "role": "Suggests" }, { "package": "mvtnorm", "role": "Suggests" }, { "package": "tuneR", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" } ], "_owner": "berrygrant", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-01", "n": 3 }, { "week": "2026-02", "n": 1 }, { "week": "2026-08", "n": 3 }, { "week": "2026-17", "n": 1 }, { "week": "2026-21", "n": 4 }, { "week": "2026-26", "n": 9 }, { "week": "2026-27", "n": 1 }, { "week": "2026-30", "n": 20 }, { "week": "2026-31", "n": 1 }, { "week": "2026-32", "n": 3 }, { "week": "2026-33", "n": 4 }, { "week": "2026-34", "n": 4 }, { "week": "2026-35", "n": 1 }, { "week": "2026-36", "n": 3 }, { "week": "2026-41", "n": 11 } ], "_tags": [ { "name": "v0.1.0", "date": "2026-02-19" }, { "name": "labphon_2026_snapshot", "date": "2026-03-03" }, { "name": "0.5.1", "date": "2026-05-22" }, { "name": "v0.5.0", "date": "2026-05-22" }, { "name": "labphon_2026_final", "date": "2026-06-25" }, { "name": "v1.0.0", "date": "2026-06-26" }, { "name": "v1.2.0", "date": "2026-07-20" }, { "name": "v2.0.0", "date": "2026-07-21" }, { "name": "v2.0.1", "date": "2026-07-21" }, { "name": "v2.0.2", "date": "2026-07-22" }, { "name": "v2.1.0", "date": "2026-07-23" }, { "name": "v2.2.0", "date": "2026-07-24" }, { "name": "v2.3.0", "date": "2026-07-28" }, { "name": "v2.3.1", "date": "2026-08-04" }, { "name": "2.4.0", "date": "2026-08-12" }, { "name": "v2.4.0", "date": "2026-08-20" }, { "name": "v2.4.1", "date": "2026-08-31" }, { "name": "v2.5.0", "date": "2026-10-06" }, { "name": "v2.5.1", "date": "2026-10-07" } ], "_stars": 1, "_contributors": [ { "user": "berrygrant", "count": 94, "uuid": 13824930 }, { "user": "codex", "count": 2, "uuid": 267193182 }, { "user": "claude", "count": 1, "uuid": 81847 } ], "_userbio": { "uuid": 13824930, "type": "user", "name": "Grant M. Berry", "followers": 8, "description": "Language. Cognition. Computation.\r\nAssistant Professor building reproducible tools for speech and brain research." }, "_downloads": { "count": 366, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/phontrast" }, "_devurl": "https://github.com/berrygrant/phontrast", "_searchresults": 9, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/phontrast.html", "extra/readme.html", "extra/readme.md", "LICENSE" ], "_homeurl": "https://github.com/berrygrant/phontrast", "_realowner": "berrygrant", "_cranurl": true, "_releases": [ { "version": "2.3.1", "date": "2026-08-09" }, { "version": "2.4.0", "date": "2026-08-21" }, { "version": "2.4.1", "date": "2026-09-08" }, { "version": "2.5.0", "date": "2026-10-07" } ], "_exports": [ "bhattacharyya_mvnorm", "boot_jsd", "compare_overlap_metrics", "estimate_bhatt", "estimate_jsd", "estimate_overlap", "estimate_pillai", "extract_mfcc", "global_boot_jsd", "global_pillai", "hier_boot_jsd_model", "inspect_contrast", "jsd", "jsd_kde_nd", "jsd_summary", "kl_div", "percent_overlap_kde", "percentile_rank", "phontrast", "phontrast_palette", "pillai_overlap", "plot_category_pca", "plot_category_space", "plot_contrast", "plot_overlap_metrics", "plot_rank_agreement", "prepare_jsd_beta", "protocol_floors", "rank_contrasts", "recommended_estimator", "scale_color_phontrast", "scale_colour_phontrast", "scale_fill_phontrast", "speaker_bhatt", "speaker_jsd", "speaker_pillai", "theme_phontrast" ], "_datasets": [ { "name": "vowel_cohort", "title": "Simulated twelve-speaker vowel cohort", "object": "vowel_cohort", "class": [ "data.frame" ], "fields": [ "speaker", "vowel", "f1", "f2" ], "rows": 2200, "table": true, "tojson": true } ], "_help": [ { "page": "bhattacharyya_mvnorm", "title": "Bhattacharyya distance and affinity under multivariate normality", "topics": [ "bhattacharyya_mvnorm" ] }, { "page": "boot_jsd", "title": "Bootstrap JSD for each group", "topics": [ "boot_jsd" ] }, { "page": "estimate_bhatt", "title": "Estimate Bhattacharyya distance, globally or by group", "topics": [ "estimate_bhatt" ] }, { "page": "estimate_jsd", "title": "Estimate Jensen-Shannon divergence or distance between two categories", "topics": [ "estimate_jsd" ] }, { "page": "estimate_overlap", "title": "Estimate proportional overlap globally or by group", "topics": [ "estimate_overlap" ] }, { "page": "estimate_pillai", "title": "Estimate Pillai trace, globally or by group", "topics": [ "estimate_pillai" ] }, { "page": "extract_mfcc", "title": "Extract MFCCs for vowel segments", "topics": [ "extract_mfcc" ] }, { "page": "global_boot_jsd", "title": "Global JSD with bootstrap confidence interval", "topics": [ "global_boot_jsd" ] }, { "page": "global_pillai", "title": "Global Pillai trace (point estimate)", "topics": [ "global_pillai" ] }, { "page": "hier_boot_jsd_model", "title": "Hierarchical bootstrap for JSD-based models", "topics": [ "hier_boot_jsd_model" ] }, { "page": "inspect_contrast", "title": "Inspect one speaker's contrast across bandwidths", "topics": [ "inspect_contrast" ] }, { "page": "jsd", "title": "Jensen-Shannon divergence for discrete distributions", "topics": [ "jsd" ] }, { "page": "jsd_kde_nd", "title": "n-dimensional JSD via multivariate kernel density estimation", "topics": [ "jsd_kde_nd" ] }, { "page": "jsd_summary", "title": "JSD summary: point estimate and optional bootstrap per group", "topics": [ "jsd_summary" ] }, { "page": "kl_div", "title": "Kullback-Leibler divergence for discrete distributions", "topics": [ "kl_div" ] }, { "page": "percent_overlap_kde", "title": "Proportional overlap between two distributions via KDE", "topics": [ "percent_overlap_kde" ] }, { "page": "percentile_rank", "title": "Percentile ranks with averaged ties", "topics": [ "percentile_rank" ] }, { "page": "phontrast", "title": "Compute and compare phonological contrast metrics", "topics": [ "phontrast" ] }, { "page": "phontrast_palette", "title": "Okabe-Ito color palette used by phontrast plots", "topics": [ "phontrast_palette" ] }, { "page": "pillai_overlap", "title": "Pillai trace for multivariate overlap", "topics": [ "pillai_overlap" ] }, { "page": "plot_category_pca", "title": "Plot a PCA projection of multidimensional category space", "topics": [ "plot_category_pca" ] }, { "page": "plot_category_space", "title": "Plot phonological categories in acoustic space", "topics": [ "plot_category_space" ] }, { "page": "plot_contrast", "title": "Distribution-aware contrast plot for two categories", "topics": [ "plot_contrast" ] }, { "page": "plot_overlap_metrics", "title": "Plot overlap metric comparisons", "topics": [ "plot_overlap_metrics" ] }, { "page": "plot_rank_agreement", "title": "Rank-agreement plot for a speaker ranking", "topics": [ "plot_rank_agreement" ] }, { "page": "plot.phontrast_contrast", "title": "Plot a phontrast() result directly", "topics": [ "autoplot.phontrast_contrast", "plot.phontrast_contrast" ] }, { "page": "plot.phontrast_ranking", "title": "Plot a rank_contrasts() result directly", "topics": [ "autoplot.phontrast_ranking", "plot.phontrast_ranking" ] }, { "page": "prepare_jsd_beta", "title": "Prepare JSD estimates for beta regression / GAMs", "topics": [ "prepare_jsd_beta" ] }, { "page": "protocol_floors", "title": "Sample-size floors of the ranking protocol", "topics": [ "protocol_floors" ] }, { "page": "rank_contrasts", "title": "Rank speakers' contrasts by Jensen-Shannon distance and check them against Pillai", "topics": [ "rank_contrasts" ] }, { "page": "recommended_estimator", "title": "Kernel estimator settings by dimensionality", "topics": [ "recommended_estimator" ] }, { "page": "scale_colour_phontrast", "title": "Okabe-Ito discrete color and fill scales", "topics": [ "scale_color_phontrast", "scale_colour_phontrast", "scale_fill_phontrast" ] }, { "page": "speaker_bhatt", "title": "Bhattacharyya distance by group", "topics": [ "speaker_bhatt" ] }, { "page": "speaker_jsd", "title": "Group-level JSD point estimates", "topics": [ "speaker_jsd" ] }, { "page": "speaker_pillai", "title": "Group-level Pillai scores", "topics": [ "speaker_pillai" ] }, { "page": "theme_phontrast", "title": "Publication theme for phontrast plots", "topics": [ "theme_phontrast" ] }, { "page": "vowel_cohort", "title": "Simulated twelve-speaker vowel cohort", "topics": [ "vowel_cohort" ] } ], "_readme": "https://github.com/berrygrant/phontrast/raw/HEAD/README.md", "_rundeps": [ "cli", "dplyr", "FNN", "generics", "glue", "kernlab", "KernSmooth", "ks", "lattice", "lifecycle", "magrittr", "Matrix", "mclust", "mgcv", "multicool", "mvtnorm", "nlme", "pillar", "pkgconfig", "pracma", "purrr", "R6", "Rcpp", "rlang", "tibble", "tidyselect", "utf8", "vctrs", "withr" ], "_vignettes": [ { "source": "multidimensional-workflows.Rmd", "filename": "multidimensional-workflows.html", "title": "Multidimensional workflows", "engine": "knitr::rmarkdown", "headings": [ "PB52 note" ], "created": "2026-06-26 14:14:17", "modified": "2026-07-21 19:26:46", "commits": 2 }, { "source": "quick-start.Rmd", "filename": "quick-start.html", "title": "Quick start: from vowel table to metrics and plots", "engine": "knitr::rmarkdown", "headings": [], "created": "2026-06-26 14:14:17", "modified": "2026-07-21 19:26:46", "commits": 2 }, { "source": "jasa-protocol.Rmd", "filename": "jasa-protocol.html", "title": "Ranking speakers by Jensen-Shannon distance and checking Pillai agreement", "engine": "knitr::rmarkdown", "headings": [ "The example cohort", "Steps 1 to 3 in one call", "Licensing: when a rank or a flag may be read", "The agreement plot", "Inspecting a flagged speaker across bandwidths", "The estimator behind the numbers", "Measures and estimators side by side", "What to report" ], "created": "2026-10-06 13:44:04", "modified": "2026-10-07 22:43:46", "commits": 2 } ], "_score": 5.653212513775344, "_indexed": true, "_nocasepkg": "phontrast", "_universes": [ "berrygrant" ], "_previous": "2.5.0.9000", "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "2.5.1", "date": "2026-10-08T09:22:39.000Z", "distro": "resolute", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/73347f25938dae2af17e3e1f2c49247ced072d7f3201c2502238a0d9ccf234ae", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.6.1", "os": "linux", "version": "2.5.1", "date": "2026-10-08T09:21:48.000Z", "distro": "resolute", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/f8d51295ca17fd84e1ff82a7d32d49ffe7f7ab44626c261349ead0a97f85545e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.5.3", "os": "mac", "version": "2.5.1", "date": "2026-10-08T09:48:10.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/201b2b58567cff0d34d37b4805da4b19b2e6d40a6450b23a0bb356a2aedcc8e4", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.6.1", "os": "mac", "version": "2.5.1", "date": "2026-10-08T09:47:02.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/b5866ec0332ac6d105d95667bc705a6cbb595016b53f4887e7aabb30f7d4858b", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.6.0", "os": "wasm", "version": "2.5.1", "date": "2026-10-08T09:21:38.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/6ffa44acd8ce9287bbe34e9b2fb7c82ccbbb89f4ecb6ad069d53e8f2be802dcc", "status": "success", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.7.0", "os": "win", "version": "2.5.1", "date": "2026-10-08T09:21:09.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/807b06f6dc5bd960c39d5d37adc65087cb74d28f812937be5b3d0734d1cf0cdb", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.5.3", "os": "win", "version": "2.5.1", "date": "2026-10-08T09:21:10.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/f020a2fd4b21a801ca1eb4d5e81cb73dc5ea61f5f4b324377450b778e3186fe8", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" }, { "r": "4.6.1", "os": "win", "version": "2.5.1", "date": "2026-10-08T09:21:06.000Z", "commit": "300c01682fc2d3667932a1b9ed60ff454221c52a", "fileid": "https://r2.ropensci.org/9bb3aa8858be98acc786306f39fc305039cc89dfbec4c24d3ad3da8554199e89", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/berrygrant/actions/runs/37755531811" } ] }