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

loveR

spectro3D(seewave)
spectro3D()所属R语言包：seewave

                                        3D-spectrogram of a time wave
                                         一时间波的三维谱图

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

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

This function returns a three-dimension spectrographic representation of a time wave. The function corresponds to short-term Fourier transform.
这个函数返回一个三维光谱的时间波表示。该功能对应于短期傅立叶变换。


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


spectro3D(wave, f, wl = 512, wn = "hanning", zp = 0,
ovlp = 0, fftw = FALSE, dB = "max0", dBref = NULL, plot = TRUE,
magt = 10, magf = 10, maga = 2,
palette = rev.terrain.colors)



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

参数：wave
an R object.      
R对象。


参数：f
sampling frequency of wave (in Hz). Does not need to be specified if embedded in wave.
wave（赫兹）的采样频率。不需要以指定如果嵌入在wave，。


参数：wl
length of the window for the analysis (even number of points).
用于分析的窗口长度（偶数的点）。


参数：wn
window name, see ftwindow (by default "hanning").
窗口的名称，请参阅ftwindow（默认情况下，"hanning"“）。


参数：zp
zero-padding (even number of points), see Details.
零填充（偶数点），请参阅Details。


参数：ovlp
overlap between two successive windows (in % ).
两个连续窗口（％）之间的重叠。


参数：fftw
if TRUE calls the function FFT of the library fftw. See Notes of the spectro.
如果TRUE调用函数FFT的库fftw。见注意的spectro。


参数：dB
a character string specifying the type dB to return: "max0" for a maximum dB value at 0, "A", "B", "C" and "D" for common dB weights.
指定的类型分贝返回一个字符的字符串：“max0”最大的dB值在0，“A”，“B”，“C”和“D”的共同分贝重量。


参数：dBref
a dB reference value when dB is TRUE. NULL by default but should be set to 2*10e-5 for a 20 microPa reference.
dB参考值时dB是TRUE。 NULL缺省情况下，但应该被设置为2 * 10e的-5 20 microPa参考。


参数：plot
logical, if TRUE plots the spectrogram (by default TRUE).
逻辑，如果TRUE图的频谱（默认情况下，TRUE）。


参数：magt
magnification of the time axis.
时间轴的放大倍率。


参数：magf
magnification of the frequency axis.
在频率轴上的放大率。


参数：maga
magnification of the amplitude axis.
放大倍数的幅度轴。


参数：palette
a color palette function to be used to assign colors in the plot, see Details.
调色板功能，可用于指定颜色的图，请参阅Details。


Details

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

Following Heisenberg uncertainty principle, the short-term Fourier transform cannot be precised in both time and frequency. The temporal and frequency precisions of the function are actually dependent of the wl value. Choosing a high wl value will increase the frequency resolution but reduce the temporal one, and vice versa. The frequency precision is obtained by calculating the ratio f/wl, and the temporal precision is obtained by calculating the reverse ratio wl/f. This problem can be reduced in some way with zp that adds 0 values on both sides of the analysis window. This increases frequency resolution without altering time resolution.<br> Any colour palette can be used. In particular, it is possible to use other palettes coming with seewave: rev.gray.colors.1, rev.gray.colors.2, spectro.colors, temp.colors, rev.heat.colors,  rev.cm.colors, rev.topo.colors, corresponding to the reverse of heat.colors,topo.colors, cm.colors.<br> Use magt, magf and maga to resize the plot.   
海森堡的不确定性原理之后，短期傅立叶变换不能被精密的时间和频率。时间和频率精度的功能实际上是依赖于wl这个值。选择一个高wl这个值将提高频率分辨率，但减少的时间，反之亦然。的频率精度是通过计算比值f/wl，和时间精度得到通过计算反向比wl/f。此问题可以以某种方式减少与zp添加0值的分析窗口的两侧上。这增加频率分辨率不改变时间分辨率的情况下可以使用任何颜色调色板。参考。特别是，它可以使用其他调色板与seewaverev.gray.colors.1，rev.gray.colors.2，spectro.colors，temp.colors，rev.heat.colors，rev.cm.colors，rev.topo.colors，对应的反向heat.colors，topo.colors，cm.colors。<BR>使用magt，magf和 maga来调整的图。


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

This function returns a list of three items:
该函数返回一个列表的三个项目：


参数：time
a numeric vector corresponding to the time axis.



参数：freq
a numeric vector corresponding to the frequency axis.
一个数值向量对应于在频率轴上。


参数：amp
a numeric matrix corresponding to the amplitude values. Each column is a Fourier transform of length wl/2.
的振幅值相对应的数值矩阵。每一列是一个傅里叶变换的长度wl/ 2。


注意----------Note----------

This function requires rgl and is based on fft. See examples of spectro for analysis arguments
此功能需要rgl和，是基于fft。例子spectro分析参数


（作者）----------Author(s)----------


Jerome Sueur <a href="mailto:sueur@mnhn.fr">sueur@mnhn.fr</a> and
Caroline Simonis <a href="mailto:csimonis@mnhn.fr">csimonis@mnhn.fr</a>.



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

spectro, dynspec,
spectro，dynspec，


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


require(rgl)
data(tico)
spectro3D(tico,f=22050,wl=512,ovlp=75,zp=16,maga=4,palette=rev.terrain.colors)

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


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