vowelplot: Plot Vowels
In phonTools: Tools for Phonetic and Acoustic Analyses

vowelplot

R Documentation

Plot Vowels

Description

A flexible function that can create a wide variety of vowel plots (including IPA symbols).

Usage

vowelplot (f1s, f2s, labels = 0, xrange = NULL, yrange = NULL, 
meansOnly = FALSE, ellipses = FALSE, ellipsesd = 1.96, add = FALSE, 
pointType = 0, colors = NULL, logaxes = '', defaultPlot = TRUE, 
alternateAxes = FALSE, xsampa = FALSE, ...)

Arguments

`f1s`	A numeric vector indicating vowel F1 frequencies.
`f2s`	A numeric vector indicating vowel F2 frequencies.
`labels`	A vector with labels for vowels. Must be provided for any category-dependent differences in plotting. If x-sampa labels are given IPA symbols may be plotted.
`xrange`	Allows the user to set the x axis range for the plot.
`yrange`	Allows the user to set the y axis range for the plot.
`meansOnly`	If TRUE, only category means are plotted (labels must be provided).
`ellipses`	If TRUE, standard deviation ellipses are drawn (one per category as indicated by label vector).
`ellipsesd`	A number indicating the number of standard deviations ellipses will enclose.
`add`	If TRUE, vowels are plotted on existing figure. If FALSE, a new one is created.
`pointType`	Kinds of points to use determined by 'pch' value. If specified it overrides text labels. IPA symbols may be plotted by finding appropriate values using the pickIPA() function included in this package.
`colors`	Colors to use for different categories. If specified this overrides automatic colors. It cycles through the list given if number of colors are less than number of categories.
`logaxes`	Linear axes are used by default. For log axes set to 'xy'.
`defaultPlot`	If TRUE, the function plots using pre-determined values. If FALSE, the user has almost complete control over the internal call of 'plot'.
`alternateAxes`	If TRUE, F1 is plotted on the y axis and F2 on the x axis with the origin in the top right corner. By default F1 is plotted on the x axis and F2 on the y axis with the origin in the bottom left corner.
`xsampa`	If TRUE, the labels vector given to the function is assumed to be specified in x-sampa and IPA symbols are used to plot using the xsampatoIPA() function included in this package. If this is set to TRUE and the 'labels' input is not in x-sampa, the symbols will be wrong.
`...`	Additional arguments are passed to the internal call of 'plot'.

Details

*** This function has been deprecated and is no longer being developed. I recommend using vplot() instead, which is more flexible and gives the user more control over plotting. ***

This function now includes functionality to easily generate vowel plots using IPA symbols. This relies on category labels being specified in x-sampa. Alternatively, the required plotting values for IPA symbols may be selected using the pickIPA() function included in this package, and then passed to the 'pointType' parameter.

There may be issues when exporting figures to PDF using IPA font. Exporting plots directly as images works 'out of the box'.

Author(s)

Santiago Barreda <sbarreda@ucdavis.edu>

References

http://en.wikipedia.org/wiki/X-SAMPA

Examples

## A few examples of some vowel plots. 

#data (pb52)
#par (mfrow = c(1,4), mar = c(4.2,4.2,1,1))

# standard layout with linear axes
#vowelplot (pb52$f1, pb52$f2, pb52$vowel, xsampa = TRUE)

# alternate layout with log axes
#vowelplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = 'xy', 
#alternateAxes = TRUE, xsampa = TRUE)

# category means only 
#vowelplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = 'xy', 
#meansOnly = TRUE, xsampa = TRUE)

# category means only with standard deviation ellipses
#vowelplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = 'xy', meansOnly = TRUE,
#           ellipses = TRUE, xsampa = TRUE)

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