createtemplate: Create an LDA Template

createtemplateR Documentation

Create an LDA Template

Description

Create a linear discriminant analysis template.

Usage

createtemplate (features, classes)

Arguments

features

A matrix of features in which each row represents a single token and each column represents a different 'feature' used to classify the token. For vowel sounds, each column should represent different single formant frequency.

classes

A vector indicating the category of each token described in each row of 'features'. The length of this vector must equal the number of rows in 'features'.

Details

This function finds the location of the mean of each class in an n-dimensional space, where each dimension corresponds to one of n columns in 'features'. In addition, the pooled, within-category covariance matrix is found.

The name for each vowel category is stored as the rownames of the 'means' element.

The function plot() is defined for template objects and allows the user to view the location of and expected variation around the different vowel categories in the formant space.

This information may be used in conjunction with the PSTM() function, included in this package. The mean and covariance matrices provided by this function may also be useful for the ldclassify() function provided in this package.

Value

A 'template' object, a list containing the elements:

classes

The category labels.

means

A matrix containing the mean location for each vowel category within the formant-space. Each row represents a different category while each column represents a different formant.

covariance

The pooled, within-category covariance matrix for the formant frequencies provided.

ranges

A matrix of dimension ranges, one row for each dimension.

Author(s)

Santiago Barreda <sbarreda@ucdavis.edu>

References

Nearey, T. M. & P. F. Assmann. (2007). Pobabilistic 'sliding template' models for indirect vowel normalization. in Experimental Approaches to Phonology, edited by M.J. Sole, P. S., Beddor, and M. Ohala (Oxford University Press, Oxford), pp. 246-269.

Examples

#data (pb52)            ## load the Peterson and Barney vowels.
## normalize them.
#normdvowels = normalize (pb52[,7:9], pb52$speaker, pb52$vowel)  
#formants = normdvowels[,1:3]
#vowels = pb52$vowel

## create a vowel template with the normalized formant frequencies
## and information about the vowel category.
#template = createtemplate (formants, vowels)

## and inspect with plot()
#plot (template, xsampa = TRUE)

phonTools documentation built on Nov. 21, 2023, 1:07 a.m.