找回密码
 注册
查看: 527|回复: 0

R语言 vowels包 vowelplot()函数中文帮助文档(中英文对照)

[复制链接]
发表于 2012-10-1 16:32:52 | 显示全部楼层 |阅读模式
vowelplot(vowels)
vowelplot()所属R语言包:vowels

                                        Plot Vowels in F1~F2 Space
                                         图中的元音,F1~F2空间

                                         译者:生物统计家园网 机器人LoveR

描述----------Description----------

Plot vowel formant data in the familiar F1~F2 dot plot format, with arrows for diphthong values.  Optionally, can add standard deviation bars, or additional overlaid vowel data sets.
图元音的共振峰数据在熟悉的F1~F2点图格式,带箭头的双元音值。或者,可以添加标准差条形,或的额外覆盖的元音数据集。


用法----------Usage----------


vowelplot(vowels, speaker=NA, color=NA, color.choice=NA,
shape="speakers", shape.choice=NA, size=NA, labels="none",
leg="speakers", a.size=NA, l.size=NA, title="", subtitle=NA,
xlim=NA, ylim=NA)

add.vowelplot(vowels, speaker=NA, color=NA, color.choice=NA,
shape="speakers", shape.choice=NA, size=NA, labels="none")

add.spread.vowelplot(vowels, mean.points=FALSE, sd.mult=2,
ellipsis=FALSE, speaker=NA, color=NA, color.choice=NA,
shape="speakers", shape.choice=NA, size = NA, leg=FALSE,
labels="none", separate=TRUE)

setup.axes(vowels)
setup.point.color(vowels, color=NA, color.choice=NA)
setup.point.shape(vowels, shape="speakers", shape.choice=NA)
setup.sizes(vowels, size=NA, a.size=NA, l.size=NA)



参数----------Arguments----------

参数: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_id,vowel_id,:背景/ N,F1,F2,F3,F1_glide,F2_glide,F3_glide。背景/ N列和滑行列可以为空。


参数:speaker
a character string specifying which speaker to plot.  If NA, the default, plots all speakers.
一个字符的字符串,指定的扬声器绘制。如果NA,默认情况下,绘制所有的扬声器。


参数: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.
一个向量使用的颜色,如果不生成黑色和白色的图,以十六进制代码或有效的的R颜色名称(见色())。如果不适用,默认情况下,使用默认的NORM颜色。


参数: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.
一个向量的点覆盖默认的形状(见说明(点),然后运行示例(“点”) -  R可以支持Unicode字符(如“近期行动计划”的符号))。如果没有足够的被指定,形状被回收作为需要。


参数: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.
如果不适用,点确定大小对数根据元音测量图的数量。覆盖绘制一个特定的CEX大小。


参数: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.
碱基规模的注释文本和点(如图形标题和轴标签)。如果NA,设置到CEX 1.0。


参数:l.size
The size for legend text and points.  If NA, is set to 75 percent of the a.size setting.
传说的文本和点的大小。如果NA,被设置为75%的a.size设置。


参数: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.
如果“元音”的的元音标识符和与点图。如果“扬声器”,图扬声器IDS为沿与点的标签。如果标签被设置为任何其它的值,以及其他除“none”,该功能包括两个扬声器id和元音作为标签的标识符。如果“无”,默认情况下,标签被抑制。


参数: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.
包括了传说中的元音图?如果是这样,扬声器或元音?如果不适用,不会产生一个传奇。默认值是“扬声器”为vowelplot()。对于add.spread.vowelplot()这是一个布尔值,默认为FALSE,TRUE,显示的数字的标准偏差所描绘的条形。


参数: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.
包括自定义字幕(在底部较小的字体标题)的图吗?如果不适用,和元音数据属性“norm.variant”或“unit.type”的!“赫兹”,字幕将默认值(按照这个顺序)。设置为空白(“”),有没有字幕,否则打印用户指定的任意。


参数: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.
指定的两个单位矢量(即作适当调整= C(800,200))如果你想覆盖的绘图区域的大小自动确定。您必须提供作适当调整和ylim为这起生效。记住,轴以外树皮差异归一化元音从最大到最小的值 - 你必须提供的值,以正确的顺序。


参数: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.
指定的两个单位向量,如果你想覆盖的绘图区域的大小自动确定。您必须提供作适当调整和ylim为这起生效。记住,轴以外树皮差异归一化元音从最大到最小的值 - 你必须提供的值,以正确的顺序。


参数: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.
对于add.spread.vowelplot()函数只。如果是TRUE,图意味着数据点的标准偏差条形。默认值是false。如果为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.
对于add.spread.vowelplot()函数只。所绘制的标准偏差范围内的乘数条形。默认值是2。


参数:ellipsis
For the add.spread.vowelplot() function only.  Should this plot ellipses rather than standard deviation bars?  Default is FALSE.
对于add.spread.vowelplot()函数只。如果该图椭圆形,而比标准偏差条形?默认值是false。


参数: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).
对于add.spread.vowelplot()函数只。如果为FALSE,这会产生条形/椭圆形晕倒在所有扬声器的数据。如果属实,这产生独立的条形/椭圆各扬声器。默认值是TRUE(请注意,默认情况下是相反的默认操作为compute.means compute.sds(),(),和的compute.medians()函数)。


Details

详细信息----------Details----------

The vowelplot() function provides helpful shortcuts for formatting vowel data frames for plotting in "standard" F2~F1 formats.  Cf. Thomas (2001) for a range of examples of vowel plots.  The add.vowelplot() function adds more vowel data to an existing plot.  It is helpful for adding, for example, mean values to a plot of individual vowels (see examples).  The add.spread.vowelplot() function computes and adds standard deviation bars or ellipses to the vowel data.
vowelplot()函数提供了一些有用的快捷键的图在“标准”F2~F1格式的的元音数据框格式。比照。托马斯(2001年)的元音图的例子。 add.vowelplot()函数添加更多的元音数据到现有的图。这是有帮助的,例如,个别元音的图平均值(参见示例)。 add.spread.vowelplot()函数计算的元音数据,并增加了标准偏差的条形或椭圆形。

The "setup" functions - setup.axes(), setup.point.color(), setup.point.shape(), and setup.sizes() - are called by vowelplot() to determine settings for the plots.
被称为“设置”功能 -  setup.axes()中,setup.point.color()中,setup.point.shape(),和setup.sizes() - ,以确定由vowelplot()设置的图。


值----------Value----------

Nothing is returned.
不返回任何值。


警告----------Warning ----------

The development of the library and this function are ongoing.  The arguments to the function may change in future version.
该库开发的功能,该功能仍在进行中。在未来版本的功能的参数可能会改变。


(作者)----------Author(s)----------


Kendall, Tyler &lt;tsk3@duke.edu&gt;<br>
with contributions from Santiago Barreda



参见----------See Also----------

load.vowels, compute.means
load.vowels,compute.means


实例----------Examples----------


vowels <- load.vowels("http://ncslaap.lib.ncsu.edu/tools/norm/downloads/CentralOhioNORM.txt")
vowelplot(vowels, color="vowels", label="vowels")

vowelplot(norm.bark(vowels), speaker="JOHG09", color="vowels", color.choice=rainbow(length(unique(vowels[,2]))), label="none", title="JOHG09 Bark Difference Normalized Vowels")
add.spread.vowelplot(norm.bark(vowels), speaker="JOHG09", sd.mult=1, color.choice=rainbow(length(unique(vowels[,2]))), color="vowels", leg=TRUE)

par(mfrow=c(2,1))
vowelplot(compute.means(vowels), shape="vowels")
vowelplot(compute.means(norm.lobanov(vowels)), shape="vowels")

par(mfrow=c(1,1))
g09.means <- compute.means(vowels, speaker="JOHG09")
vowelplot(g09.means, color="vowels", labels="none")
add.spread.vowelplot(vowels, speaker="JOHG09", sd.mult=1, color="vowels", labels="none")
# can add annotations to the vowel plots as any other R graph, eg:[可以添加注释的任何其他R图,例如元音图:]
legend("top", legend="Can you guess which vowel is 'BOY'?", col='lightslategrey', bty="n")

vowelplot(norm.nearey(vowels), speaker="JOHG09", color="speakers", labels="vowels", title="Individual vowels and means for JOHG09\nNearey1 Normalized")
add.vowelplot(compute.means(norm.nearey(vowels), speaker="JOHG09"), color=NA, size=2, labels="vowels")

vowelplot(norm.wattfabricius(vowels), speaker="JOHG09", shape="vowels", color="vowels", color.choice=sample(colors(), length(unique(vowels[,2]))), leg="vowels", title="Randomly colored vowels for JOHG09\nWatt &amp; Fabricious normalized")

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注:
注1:为了方便大家学习,本文档为生物统计家园网机器人LoveR翻译而成,仅供个人R语言学习参考使用,生物统计家园保留版权。
注2:由于是机器人自动翻译,难免有不准确之处,使用时仔细对照中、英文内容进行反复理解,可以帮助R语言的学习。
注3:如遇到不准确之处,请在本贴的后面进行回帖,我们会逐渐进行修订。
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

手机版|小黑屋|生物统计家园 网站价格

GMT+8, 2024-11-26 01:23 , Processed in 0.020445 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表