spectro(seewave)
spectro()所属R语言包：seewave
2D-spectrogram of a time wave
二维频谱的波
译者：生物统计家园网 机器人LoveR
描述----------Description----------
This function returns a two-dimension spectrographic representation of a time wave. The function corresponds to short-term Fourier transform.
这个函数返回一个二维光谱的时间波表示。该功能对应于短期傅立叶变换。
用法----------Usage----------
spectro(wave, f, wl = 512, wn = "hanning", zp = 0,
ovlp = 0, fftw = FALSE, dB = "max0", dBref = NULL, plot = TRUE,
grid = TRUE, osc = FALSE, scale = TRUE, cont = FALSE,
collevels = NULL, palette = spectro.colors,
contlevels = NULL, colcont = "black",
colbg = "white", colgrid = "black",
colaxis = "black", collab="black",
cexlab = 1, cexaxis = 1,
tlab = "Time (s)",
flab = "Frequency (kHz)",
alab = "Amplitude",
scalelab = "Amplitude\n(dB)",
main=NULL,
scalefontlab = 1, scalecexlab =0.75,
axisX = TRUE, axisY = TRUE, tlim = NULL, trel = TRUE,
flim = NULL, flimd = NULL,
widths = c(6,1), heights = c(3,1),
oma = rep(0,4),
listen=FALSE,
...)
参数----------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
window length for the analysis (even number of points) (by default = 512)
分析（偶数点）的窗口长度（默认值= 512）
参数：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.
如果TRUE调用函数FFT的库fftw。见注解。
参数：dB
a character string specifying the type dB to return: "max0" (default) for a maximum dB value at 0, "A", "B", "C" and "D" for common dB weights.
一个字符串，返回指定类型分贝：“max0”（默认值）的最高分贝值在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参考。
参数：wn
window name, see ftwindow (by default "hanning").
窗口的名称，请参阅ftwindow（默认情况下，"hanning"“）。
参数：plot
logical, if TRUE plots the spectrogram (by default TRUE).
逻辑，如果TRUE图的频谱（默认情况下，TRUE）。
参数：grid
logical, if TRUE plots a y-axis grid (by default TRUE).
逻辑，如果TRUE图y轴网格（默认情况下TRUE）。
参数：osc
logical, if TRUE plots an oscillogram beneath the spectrogram (by default FALSE).
逻辑，如果TRUE图下面的波形的频谱（默认情况下FALSE）。
参数：scale
logical, if TRUE plots a dB colour scale on the right side of the spectrogram (by default TRUE).
逻辑，如果TRUE图频谱图的右侧（默认情况下，一个分贝色标TRUE）。
参数：cont
logical, if TRUE overplots contour lines on the spectrogram (by default FALSE).
逻辑，如果TRUEoverplots轮廓线频谱图上（默认情况下FALSE）。
参数：collevels
a set of levels which are used to partition the amplitude range of the spectrogram (in dB).
一组用于分区的谱图（以dB为单位）的幅度范围的水平。
参数：palette
a color palette function to be used to assign colors in the plot, see Details.
调色板功能，可用于指定颜色的图，请参阅Details。
参数：contlevels
a set of levels which are used to partition the amplitude range for contour overplot (in dB).
一组用于分区轮廓overplot（以dB为单位）的振幅范围的水平。
参数：colcont
colour for cont plotting.
cont绘制的颜色。
参数：colbg
background colour.
背景颜色。
参数：colgrid
colour for grid plotting.
grid绘制的颜色。
参数：colaxis
color of the axes.
轴的颜色。
参数：collab
color of the labels.
颜色的标签。
参数：cexlab
size of the labels.
标签的大小。
参数：cexaxis
size of the axes.
轴的大小。
参数：tlab
label of the time axis.
时间轴标签。
参数：flab
label of the frequency axis.
在频率轴上的标签。
参数：alab
label of the amplitude axis.
标签的振幅轴。
参数：scalelab
amplitude scale label.
振幅刻度标签。
参数：main
label of the main title.
主标题的标签。
参数：scalefontlab
font of the amplitude scale label.
振幅刻度标签的字体。
参数：scalecexlab
cex of the amplitude scale label.
CEX的幅度比例标签。
参数：axisX
logical, if TRUE plots time X-axis (by default TRUE).
逻辑，如果TRUE图X-轴（默认情况下TRUE）。
参数：axisY
logical, if TRUE plots frequency Y-axis (by default TRUE).
逻辑，如果TRUE图频Y-轴（默认情况下TRUE）。
参数：tlim
modifications of the time X-axis limits.
修改的时间X轴限制。
参数：trel
time X-axis with a relative scale when tlim is not null, i.e. relative to wave.
X-轴的相对比例时tlim不为空，即相对于wave。
参数：flim
modifications of the frequency Y-axis limits.
Y轴的频率限制的修改。
参数：flimd
dynamic modifications of the frequency Y-axis limits. New wl and ovlp arguments are applied to increase time/frequency resolution.
动态修改的频率Y轴范围。新的wl和ovlp参数来增加时间/频率分辨率。
参数：widths
a vector of length 2 to control the relative widths of columns on the device when scale is TRUE.
长度为2的向量控制时的移动设备上的列的相对宽度scale是TRUE。
参数：heights
a vector of length 2 to control the relative heights of rows on the device when osc is TRUE.
长度为2的矢量控制当osc是TRUE：在设备上的行的相对高度。
参数：oma
a vector of length 4 to control the size of outer margins when either scale or osc is TRUE.
一个向量的长度为4的大小来控制的外边缘时，无论scale或osc是TRUE。
参数：listen
if TRUE the sound is played back (by default FALSE).
如果TRUE的声音回放（默认情况下，FALSE）。
参数：...
other contour and oscillo graphical parameters.
其他contour和oscillo图形参数。
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: temp.colors, rev.gray.colors.1, rev.gray.colors.2, rev.heat.colors, rev.terrain.colors, rev.topo.colors, rev.cm.colors corresponding to the reverse of heat.colors, terrain.colors, topo.colors, cm.colors.<br> Use locator to identify points.
海森堡的不确定性原理之后，短期傅立叶变换不能被精密的时间和频率。时间和频率精度的功能实际上是依赖于wl这个值。选择一个高wl这个值将提高频率分辨率，但减少的时间，反之亦然。的频率精度是通过计算比值f/wl，和时间精度得到通过计算反向比wl/f。此问题可以以某种方式减少与zp添加0值的分析窗口的两侧上。这增加频率分辨率不改变时间分辨率的情况下可以使用任何颜色调色板。参考。特别是，它可以使用其他调色板与seewavetemp.colors，rev.gray.colors.1，rev.gray.colors.2，rev.heat.colors，rev.terrain.colors，rev.topo.colors，rev.cm.colors相应的反向heat.colors，terrain.colors，topo.colors，cm.colors。<BR>使用locator识别点。
值----------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----------
The argument fftw can be used to try to speed up process time. When set to TRUE, the Fourier transform is computed through the function FFT of the package fftw. This pacakge is a wrapper around the fastest Fourier transform of the free C subroutine
参数fftw可以尝试加快处理时间。当设置为TRUE，傅立叶变换计算通过FFT包fftw的功能。该线路咨询是免费的C子程序周围的包装最快的傅立叶变换
注意----------Note----------
This function is based on fft, contour and
此功能是基于fft，contour和
（作者）----------Author(s)----------
Jerome Sueur and Caroline Simonis.
参考文献----------References----------
参见----------See Also----------
spectro3D, dynspec, wf,
spectro3D，dynspec，wf，
实例----------Examples----------
data(tico)
data(pellucens)
# simple plots[简单图]
spectro(tico,f=22050)
spectro(tico,f=22050,osc=TRUE)
spectro(tico,f=22050,scale=FALSE)
spectro(tico,f=22050,osc=TRUE,scale=FALSE)
# change the dB scale by setting a different dB reference value (20 microPa)[更改数据库规模，通过设置不同的dB参考值（20 microPa）]
spectro(tico,f=22050, dBref=2*10e-5)
# manipulating wl[操作WL]
op<-par(mfrow=c(2,2))
spectro(tico,f=22050,wl=256,scale=FALSE)
title("wl = 256")
spectro(tico,f=22050,wl=512,scale=FALSE)
title("wl = 512")
spectro(tico,f=22050,wl=1024,scale=FALSE)
title("wl = 1024")
spectro(tico,f=22050,wl=4096,scale=FALSE)
title("wl = 4096")
par(op)
# vertical zoom using flim[垂直缩放FLIM]
spectro(tico,f=22050, flim=c(2,6))
spectro(tico,f=22050, flimd=c(2,6))
# a full plot[一个完整的图]
pellu2<-cutw(pellucens,f=22050,from=1,plot=FALSE)
spectro(pellu2,f=22050,ovlp=85,zp=16,osc=TRUE,
cont=TRUE,contlevels=seq(-30,0,20),colcont="red",
lwd=1.5,lty=2,palette=rev.terrain.colors)
# black and white spectrogram [黑色和白色的频谱]
spectro(pellu2,f=22050,ovlp=85,zp=16,
palette=rev.gray.colors.1)
# colour modifications[颜色修改]
data(sheep)
spectro(sheep,f=8000,palette=temp.colors,collevels=seq(-115,0,1))
spectro(pellu2,f=22050,ovlp=85,zp=16,
palette=rev.cm.colors,osc=TRUE,colwave="orchid1")
spectro(pellu2,f=22050,ovlp=85,zp=16,osc=TRUE,palette=rev.heat.colors,
colbg="black",colgrid="white", colwave="white",colaxis="white",collab="white")
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-30 00:20:01
