nzilbb.vowels

Vowel Covariation Tools


License
MIT

Documentation

nzilbb.vowels nzilbb.vowels website

R-CMD-check DOI

The nzilbb.vowels packages contains useful functions and data for the investigation of vocalic covariation. The core of the package is a set of functions to aid PCA-based studies of monophthongs.

The package evolves along with ongoing research on vocalic covariation carried out at NZILBB.

Installation

Development version

You can install the development version of nzilbb.vowels from GitHub with:

# install.packages("devtools")
devtools::install_github("nzilbb/nzilbb_vowels")

Example

library(nzilbb.vowels)
#> Loading required package: patchwork
ggplot2::theme_set(ggplot2::theme_bw())

# normalise vowels using Lobanov 2.0 normalisation (see Brand et al. (2021))
onze_vowels <- onze_vowels |> 
  lobanov_2()

# apply PCA to random intercepts from GAMM models (again, from Brand et al. (2021))
onze_pca <- prcomp(
  onze_intercepts |> dplyr::select(-speaker),
  scale = TRUE
)

# Test PCA using bootstrapping approach (see Wilson Black et al. (2022))
onze_pca_test <- pca_test(onze_intercepts |> dplyr::select(-speaker))

# Plot variance explained by each PC.
plot_variance_explained(onze_pca_test)

# Plot index loadings of PC1
plot_loadings(onze_pca_test)

# Plot PC in vowel space
plot_pc_vs(onze_vowels, onze_pca_test)

For more information, see Wilson Black et al. (2022) and associated supplementary material.

RStudio Add-in

It is often useful to have Wells lexical sets in small capitals in R Markdown documents. The way to achieve this manually is to add “vowel”. This package includes an RStudio add in, which can be attached to a keyboard shortcut. (see ‘Addins’ at the top of the RStudio window). This add in works for both Quarto and RMarkdown files.