Usage
plotVowels(vowel, f1, f2, f3=NULL, f0=NULL, grouping.factor=NULL,
data=NULL, norm.method='none', match.unit=TRUE,
match.axes='absolute', points='text', means='text',
points.alpha=0.3, means.alpha=1, ignore.hidden=TRUE,
ellipses=TRUE, ellipse.size=0.3173, polygon=TRUE,
poly.order=c('i','','e','','','a','',
'','','o','','u','',''),
poly.include=NULL, single.plot=TRUE, axis.col='#666666FF',
titles='auto', grayscale=FALSE, vary.shapes=grayscale,
vary.lines=grayscale, uniform.style=!single.plot,
legend=single.plot, aspect.ratio=NULL, plot.dims=c(7,7),
plot.unit='in', output='screen')
- vowel
{Vector (or column from data) of vowel symbols.}
- f1
{Vector (or column from data) of F1 values.}
- f2
{Vector (or column from data) of F2 values.}
- f3
{Vector (or column from data) of F3 values (required for normalization method nearey2).}
- f0
{Vector (or column from data) of f0 values (required for normalization method nearey2).}
- grouping.factor
{Vector (or column from data) of grouping factor values. Allows for plotting data by color/shape/linestyle (if single.plot is TRUE), or separating to individual plots (if single.plot is FALSE).}
- data
{Optional data frame containing the values to be plotted. If data is specified, be sure to enclose the values of f0, f1, f2, f3, vowel, and grouping.factor in quotes.}
- norm.method
{Normalization method to use to transform data before plotting. Possible values are none, bark, mel, erb, log, z|zscore|ztransform|lobanov, logmean|nearey1, nearey2, s|scentroid|wattfabricius.}
- match.unit
{If TRUE (and norm.method is not none), axis tickmarks will be in the normalized unit. If FALSE (and norm.method is not none), axis tickmark values will be in Hertz, with tickmark locations scaled according to the chosen normalization method.}
- match.axes
{If absolute, all plots have same bounds. If relative, all plots span the same range, but may have different endpoints. If none, extrema are calculated separately for each plot. Ignored (coerced to absolute) if single.plot is TRUE.}
- points
{If text, plots vowel tokens with the character string given in vowel. If shape, plots vowel tokens as geometric shapes. If none, omits plotting the vowel tokens.}
- means
{If text, plots vowel means with the character string given in vowel. If shape, plots vowel means as geometric shapes. If none, omits plotting the vowel means.}
- points.alpha
{Opacity of individual vowel points (permissible values between 0 and 1 inclusive.)}
- means.alpha
{Opacity of vowel means (permissible values between 0 and 1 inclusive.)}
- ignore.hidden
{If TRUE and if points is none, plotting dimensions are calculated based only on means, (or ellipses, if present).}
- ellipses
{If TRUE, plot an ellipse around each vowel mean tracing an equidensity contour of the bivariate normal distribution.}
- ellipse.size
{Size of the ellipse [0,1] expressed as an alpha-level (i.e., 0.05 gives a 95% confidence ellipse). Defaults to alpha level of 0.3173 (equivalent to an ellipse encompassing plus-or-minus 1 standard deviation from the mean). Note that because this is an alpha level, HIGHER numbers give SMALLER ellipses.}
- polygon
{If TRUE, draw a series of line segments connecting the vowel means, in the order given by poly.order.}
- poly.order
{Vector of strings determining the order in which connecting lines are drawn for the vowel polygon. Should match the levels of the factor vowel.}
- poly.include
{Indicates how many of the vowels in poly.order should be connected into a polygon. To exclude vowels from the polygon drawing, put them at the end of poly.order and provide a value for poly.include shorter than the length of poly.order.}
- single.plot
{If TRUE, plot each value of the grouping factor on the same graph. If FALSE and output is screen, result is an on-screen lattice plot. If FALSE and output is pdf or jpg, result is a collection of separate PDF or JPG files (one per level of grouping.factor).}
- axis.col
{Color for the axis lines, ticks, numbers, and labels.}
- titles
{If auto, will auto-generate titles based on grouping.factor. If none, titles are omitted. Also accepts a single string (all titles will be the same), or a vector of strings that matches the number of levels in grouping.factor.}
- grayscale
{If TRUE, plot without color. Note that if grayscale is FALSE, graphs may still come out colorless if uniform.style is TRUE and there is only one group on the graph, because the first color plotted defaults to black.}
- vary.shapes
{If TRUE, vary token or mean shapes by group (when either points or means has the value shape). Defaults to same value as grayscale. Ignored if uniform.style is TRUE.}
- vary.lines
{If TRUE, vary line style by group (when ellipses or polygon are TRUE). Defaults to same value as grayscale. Ignored if uniform.style is TRUE.}
- uniform.style
{If TRUE, plot each group's data using the same color, shape, and linestyle. If unspecified, defaults to the opposite value as single.plot.}
- legend
{If TRUE, prints a legend in the lower left corner of the graph.}
- aspect.ratio
{Aspect ratio for plot area. Default is NULL, which changes the aspect ratio to maximize use of the available plot area; if specified, must be a positive numeric value.}
- plot.dims
{A vector of length two, giving width & height of the plot. Ignored when output is screen.}
- plot.unit
{Unit of plot dimensions: in, cm, etc. Ignored when output is screen.}
- output
{Possible values are screen, pdf, jpg.}
[object Object],[object Object]
McCloy, D. R. 2012 Normalizing and plotting vowels with the phonR package. Technical Reports of the UW Linguistic Phonetics Laboratory. http://depts.washington.edu/phonlab/pubs/McCloy2012_phonR.pdf
normalizeVowels
device
hplot