# Plot Vowels

### Description

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

### Usage

1 2 3 |

### Arguments

`x` |
A numeric vector indicating formant frequencies to be plotted on the x axis. |

`y` |
A numeric vector indicating formant frequencies to be plotted on the y axis. |

`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. |

`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. |

`points` |
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. |

`meansonly` |
If TRUE, only category means are plotted (labels must be provided). |

`ellipsesd` |
If a number greater than zero is given, ellipses are drawn enclosing this many standard deviations (one per category as indicated by label vector). |

`add` |
If TRUE, vowels are plotted on existing figure. If FALSE, a new one is created. |

`logaxes` |
Linear axes are used by default, for log axes set to TRUE. |

`alternateaxes` |
If TRUE, the origin in the top right corner of the plot, resulting in a configuration like the IPA vowel quadrilateral if F1 and F2 are provided. By default 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 replaces the older vowelplot() function, which has been deprecated. ***

A flexible vowel plotting function, including functionality to easily generate vowel plots using IPA symbols. This relies on category labels being specified in x-sampa (the required plotting values for IPA symbols may be selected using the pickIPA() function included in this package).

Default parameter values are set for the plot, but these may all be overridden using the standard plotting parameters.

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 | ```
## A few examples of some vowel plots.
## load the Peterson and Barney data
data (pb52)
pb52 = pb52[pb52$type=='m',] ## use only the males
par (mfrow = c(3,2), mar = c(4.2,4.2,1,1))
# standard layout with linear axes
vplot (pb52$f1, pb52$f2, pb52$vowel, xsampa = TRUE)
# alternate layout with log axes
vplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = TRUE,
alternateaxes = TRUE, xsampa = TRUE)
# category means only
vplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = TRUE,
meansonly = TRUE, xsampa = TRUE, cex = 3)
# category means only with standard deviation ellipses
vplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = FALSE,
meansonly = TRUE, ellipsesd = 2, xsampa = TRUE)
# same as above, with alternate axes
vplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = TRUE,
meansonly = TRUE, ellipsesd = 2, xsampa = TRUE,
alternateaxes = TRUE)
# individual points with standard deviation ellipses
# and alternate axes
vplot (pb52$f1, pb52$f2, pb52$vowel, logaxes = TRUE,
meansonly = FALSE, ellipsesd = 2, xsampa = TRUE,
alternateaxes = TRUE)
``` |