- vowels
a required dataframe of the format: speaker_id, vowel_id, context/N, F1, F2, F3, F1_glide, F2_glide, F3_glide. The context/N column and the glide columns can be blank.
- speaker
a character string specifying which speaker to plot. If NA, the default, plots all speakers.
- color
Use color to differentiate "speakers" or "vowels". If NA, the default, plots in black and white.
- color.choice
A vector of colors to use if not generating a black and white plot, in hex code or valid R color name (see color()). If NA, the default, uses the default NORM colors.
- shape
Use plot shapes to differentiate "speakers" or "vowels". Defaults to using shapes for "speakers".
- shape.choice
A vector of point shapes for overriding the defaults (see help for points() and run example("points") - your R may support Unicode characters (IPA-like symbols)). If not enough are specified, the shapes are recycled as needed.
- size
If NA, the dot sizes are determined logarithmically based on the number of vowel measurements to plot. Override to plot with a specific cex size.
- a.size
The base size for annotation text and points (such as the plot title and axis labels). If NA, is set to cex 1.0.
- l.size
The size for legend text and points. If NA, is set to 75 percent of the a.size setting.
- labels
If "vowels", plots the vowel identifier along with the dots. If "speakers", plots the speaker ids as labels along with the dots. If labels is set to any other value, other than "none", the function includes both the speaker id and the vowel identifier as the labels. If "none", the default, labels are suppressed.
- leg
Include a legend in the vowel plot? If so, for speakers or vowels? If NA, do not generate a legend. Default is "speakers" for vowelplot(). For add.spread.vowelplot() this is a boolean, defaulting to FALSE, which, if TRUE, shows the number of standard deviations depicted by the bars.
- title
Include a custom main title for the plot? If blank (""), will generate a title based on the data submitted to the function.
- subtitle
Include a custom subtitle (smaller font title at the bottom) for the plot? If NA, and the vowel data has attributes of "norm.variant" or "unit.type"!="Hertz", the subtitle will default to those values (in that order). Set to blank (""), to have no subtitle, otherwise prints whatever user specifies.
- xlim
Specify with a two-unit vector (i.e. xlim=c(800, 200)) if you want to override the automatic determination of the size of the plot area. You must provide both xlim and ylim for this take effect. Remember that for other than Bark difference normalized vowels, axes run from largest to smallest value - you must provide the values in the correct order.
- ylim
Specify with a two-unit vector if you want to override the automatic determination of the size of the plot area. You must provide both xlim and ylim for this take effect. Remember that for other than Bark difference normalized vowels, axes run from largest to smallest value - you must provide the values in the correct order.
- mean.points
For the add.spread.vowelplot() function only. If TRUE, plot mean data points in addition to the standard deviation bars. Default is FALSE. The "shape" and "size" arguments are ignored if FALSE.
- sd.mult
For the add.spread.vowelplot() function only. The multiplier for the range of standard deviations plotted by the bars. Default is 2.
- ellipsis
For the add.spread.vowelplot() function only. Should this plot ellipses rather than standard deviation bars? Default is FALSE. Set to TRUE for ellipsis. As of Vowels 1.2 this makes 'true' ellipsis around the dimensions of variation. For the original version, which plotted horizontal-vertical ellipses only, set to "horizvert".
- separate
For the add.spread.vowelplot() function only. If FALSE, this generates bars/ellipses collapsed across all speakers in the data. If TRUE, this generates separate bars/ellipses for each speaker. The default is TRUE (note that this default is the opposite of the default action for the compute.means(), compute.sds(), and compute.medians() functions).