README.md
In nzilbb.vowels: Vowel Covariation Tools

nzilbb.vowels: Vowel Covariation Tools

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.

Install from CRAN:

install.packages('nzilbb.vowels')

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

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

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.

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.