sii(SII)
sii()所属R语言包：SII
Compute ANSI S3.5-1997 Speech Intelligibility Index (SII)
计算ANSI S3.5-1997的语音清晰度指数（SII）
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Compute the Speech Intelligibility Index (SII) described by ANSI specification S3.5-1997, including extensions for conductive hearing loss. Optionally apply interpolation obtain values for the required frequencies.
计算所描述的ANSI S3.5-1997规格，包括扩展的传导性听力损失的语音清晰度指数（SII）。也可以申请插值获得所需的频率值。
用法----------Usage----------
sii(speech = c("normal", "raised", "loud", "shout"),
noise, threshold, loss, freq,
method = c("critical", "equal-contributing",
"one-third octave", "octave"),
importance = c("SII", "NNS", "CID22", "NU6", "DRT",
"ShortPassage", "SPIN", "CST"),
interpolate=FALSE)
## S3 method for class 'SII'
print(x, digits=3, ...)
## S3 method for class 'SII'
plot(x, ...)
## S3 method for class 'SII'
summary(object, digits=2, ...)
参数----------Arguments----------
参数：speech
Either a numeric vector providing E'[i], the equivalent speech spectrum level (in dB) at each frequency, or a character string indicating the stated vocal effort corresponding to one of the standard standard speech spectrum levels ("normal", "raised", "loud", "shout"). Defaults to speech="normal" correspoding to the normal level of stated vocal effort.
无论是数字矢量E'[i]，在每个频率的等效语音频谱水平（以dB为单位），或一个字符串，表示既定的声乐努力对应于一个标准的标准语音频谱的水平（“正常”，“提高“，”大声“，”呐喊“）。默认为speech="normal"的correspoding到正常水平的陈述的声乐努力。
参数：noise
A numeric vector providing N'[i], the equivalent noise spectrum level (in dB) at each frequency. If missing, defaults to -50 dB for each frequency.
一个数值向量提供N'[i]，等效噪声的频谱电平（以dB为单位），在每一个频率。如果缺少，默认为每一个频率到-50 dB。
参数：threshold
A numeric vector providing T'[i], the equivalent hearing threshold level (in dB) at each frequency. If missing, defaults to 0 dB for each frequency.
一个数值向量提供T'[i]，相当于在每一个频率的听力阈值电平（以dB为单位）。如果缺少，默认为每一个频率为0 dB。
参数：loss
A numeric vector providing J'[i], the conductive hearing loss level (in dB) at each frequency. If missing, defaults to 0 dB for each frequency.
一个数值向量提供J'[i]，在每个频率的传导性听力损失程度（分贝）。如果缺少，默认为每一个频率为0 dB。
参数：freq
Vector of frequencies for which speech, noise, threshold, and/or loss are specified. If interpolate=TRUE, freq must be specified. Otherwise, it must either match the required value for SII calculation method given by argument method, or be missing, in which case it will default to the values required for the specified method.
向量speech，noise，threshold，和/或loss指定的频率。如果interpolate=TRUE，freq必须被指定。否则，它必须与之相匹配的值SII计算方法给出的参数method，或丢失，在这种情况下，它会默认为需要的值指定的方法。
参数：method
A character string specifying the SII calculation method ("critical", "one-third octave", "equal-contributing", "octave")
一个字符串指定SII的计算方法（“关键”，“三分之一倍频程”，“平等贡献”，“八音”）
参数：importance
Either a numeric vector providing F[i], the transfer function (importance weights) at each frequency, or a character string indicating which transfer function to employ ("SII", "NNS", "CID22", "NU6", "DRT", "ShortPassage", "SPIN", "CST"). Defaults to the standard SII transfer function, importance="SII".
要么一个数值向量提供F[i]，在每个频率的传递函数（权重），或者是一个字符串表示雇用的传递函数（“SII”，“NNS”，“CID22”中，“NU6”，“ DRT“，”ShortPassage“，”SPIN“，”CST“）。默认值，以标准SII转移功能，importance="SII"。
参数：interpolate
Logical flag indicating whether to interpolate from the provide measurement values and frequencies to those required by the specified method via linear interpolation on the log scale.
逻辑标志指示是否进行插值从所提供的测量值，通过线性内插的对数标度上的指定的方法所要求的频率。
参数：object,x
SII object
SII对象
参数：digits
Number of digits to display
数位显示
参数：...
Optional arguments to print, summary, and plot methods
可选参数print，summary和plot方法
Details
详细信息----------Details----------
American National Standard ANSI S3.5-1997 ("Methods for Calculation of the Speech Intelligibility Index") defines a method for computing a physical measure that is highly correlated with the intelligibility of speech as evaluated by speech perception tests given a group of talkers and listeners. This measure is called the Speech Intelligibility Index, or SII. The SII is calculated from acoustical measurements of speech and noise.
美国国家标准ANSI S3.5-1997（“”的语音清晰度指数的计算方法）定义了一个方法，计算物理测量高度相关的评价言语感知语言的可理解性测试给定的一组健谈，听众。这项措施被称为语音清晰度指数，或SII。 SII计算的语音和噪声的声学测量。
The sii function implements ANSI S3.5-1997 as described in the standard, without any attempt to optimize the performance. The implementation does, however, include the extension for handling conductive hearing loss from Annex A (utilizing the optional loss argument), and for utilizing alternative band weights (i.e. transfer function) appropriate for differing message contents (e.g. types of speech) as described in Annex B or user-specified band weights (utilizing the optional argument importance).
sii功能实现了ANSI S3.5-1997标准中所描述的，没有任何企图以优化的性能。然而，实现中，包括扩展的从附件A（利用可选loss参数），和用于利用替代带权重（即传递函数）适合于不同的消息内容（例如，类型的语音处理传导性听力损失），如附件B或用户指定的带权重（使用可选的参数importance“）。
Further, this implementation provides a mechanism for interpolating/extrapolating available measurements to those required for the specified calculation procedure. When interpolate=TRUE, required values for speech, noise, threshold, and loss will be computed using linear interpolation (of the log-scaled data). In this case, missing values may be provided and will be appropriately interpolated.
另外，该实施提供了一种机制，用于内插/外推那些指定的计算过程所需的可用的测量。当interpolate=TRUE，所需的值speech，noise，threshold和loss将使用线性插值的对数标度的数据计算。在这种情况下，可以提供和缺失值，将适当地插值。
值----------Value----------
The return value is an object of class SII, containing the following components: <table summary="R valueblock"> <tr valign="top"><td>call</td> <td> Function call used to generate the SII object</td></tr> <tr valign="top"><td>orig</td> <td> List containing original (pre-extrapolation) values for freq, speech, noise, threshold, and loss.</td></tr> <tr valign="top"><td>speech, noise, threshold, loss, and freq</td> <td> Values used in calculations (extrapolated if necessary)</td></tr> <tr valign="top"><td>table</td> <td> SII calculation worksheet, containing columns corresponding to both Table C.1 and C.2 in Annex C of the standard. Table columns are
返回值是一个SII的类的对象，包含以下组件：<table summary="R valueblock"> <tr valign="top"> <TD> call </ TD> <TD>功能调用使用生成的SII对象</ TD> </ TR> <tr valign="top"> <TD> orig </ TD> <TD>列表，其中包含原来的值（预外推）freq ，speech，noise，threshold和loss。</ TD> </ TR> <tr valign="top"> <TD>speech, noise, threshold, loss, and freq </ TD> <TD>在计算中使用的值（外推如果必要的话）</ TD> </ TR> <tr valign="top"> <TD>table </ TD> <TD> SII计算工作表，列相应的标准附件C表C.1和C.2。表列
FiCenter frequency of SII band, Hz
FiCenter SII频率的波段，频率
E'iSpectrum level of equivalent speech, dB
EiSpectrum水平相当的讲话，分贝
N'iSpectrum level of equivalent noise, dB
NiSpectrum等效噪声（分贝）
T'iEquivalent hearing threshold level, dB
TiEquivalent听力阈值水平，分贝
ViSpectrum level for self-speech masking, dB
ViSpectrum自助语音屏蔽，分贝
BiLarger of the specrum levels for equivalent noise and self-speech masking, dB
等效噪声BiLarger的specrum水平和自我讲话屏蔽，分贝
CiSlope per octave (doubling of frequency) of the upward spread of masking, dB/octave
掩蔽，分贝/倍频程的向上蔓延CiSlope每倍频程（翻一番频率）
ZiSpectrum level for equivalent masking, dB
ZiSpectrum水平相当于屏蔽，分贝
XiSpectrum level of internal noise, dB
XiSpectrum级别的内部噪声（分贝）
X'iSpectrum level of equivalent internal noise, dB
XiSpectrum等效噪声（分贝）
DiSpectrum level for equivalent disturbance, dB
DiSpectrum水平相当的干扰，分贝
UiSpectrum level of standard speech for normal vocal effort, dB
UiSpectrum水平的正常声音的努力，分贝为标准语音
JiEquivalent hearing threshold due to conductive hearing loss, dB
JiEquivalent的听力阈值，由于传导性耳聋，分贝
LiSpeech level distortion factor, dB
LiSpeech水平失真的因素，分贝
KiTemporary variable used in the calculation of the band auditability function
带可审计性功能的计算中使用的变量KiTemporary
AiBand auditability function
AiBand可审计性功能
IiBand importance function
IiBand重要的功能
IiAiProduct of the band importance function (Ii), and band auditability function(Ai) </td></tr> <tr valign="top"><td>sii</td> <td> Calculated SII value</td></tr> </table>
IiAiProduct的乐队重要功能（Ⅱ），以及功能带可审计性（AI）</ TD> </ TR> <tr valign="top"> <TD>sii </ TD> <TD>计算SII值</ TD> </ TR> </ TABLE>
（作者）----------Author(s)----------
Gregory R. Warnes <a href="mailto:greg@warnes.net">greg@warnes.net</a>
参考文献----------References----------
ANSI S3.5-1997, "American National Standard Methods for Calculation of the Speech Intelligibility Index" American National Standards Institute, New York.
Other software programs for calculating SII are available from http://www.sii.to/html/programs.html.
参见----------See Also----------
SII Constants: critical, and
SII常数：critical，
实例----------Examples----------
## Example C.1 from ANSI S3.5-1997 Annex C[ANSI S3.5-1997＃示例C.1附件C]
sii.C1 <- sii(
speech = c(50.0, 40.0, 40.0, 30.0, 20.0, 0.0),
noise = c(70.0, 65.0, 45.0, 25.0, 1.0,-15.0),
threshold= c( 0.0, 0.0, 0.0, 0.0, 0.0, 0.0),
method="octave"
)
sii.C1 # rounded to 2 digits by default[默认情况下，四舍五入到2位]
print(sii.C1$sii, digits=20) # full precision[全精度]
summary(sii.C1) # full details[详细资料]
plot(sii.C1) # plot[图]
## The value given in the Standard is $0.504$.[＃标准中给定的值是0.504美元元。]
## Same calculation, but manually specify the frequencies[同样的计算，但是手动指定频率]
## and importance function, and use default for threshold[＃和重要功能，并使用默认的阈值]
sii.C1 <- sii(
speech = c(50.0, 40.0, 40.0, 30.0, 20.0, 0.0),
noise = c(70.0, 65.0, 45.0, 25.0, 1.0,-15.0),
method="octave",
freq=c(250, 500, 1000, 2000, 4000, 8000),
importance=c(0.0617, 0.1671, 0.2373, 0.2648, 0.2142, 0.0549)
)
sii.C1
## Now perform the calculation using frequency weights for the Connected[＃现在执行使用频率的权重计算的关连]
## Speech Test (CST)[言语测试（CST）]
sii.CST <- sii(
speech = c(50.0, 40.0, 40.0, 30.0, 20.0, 0.0),
noise = c(70.0, 65.0, 45.0, 25.0, 1.0,-15.0),
method="octave",
importance="CST"
)
round(sii.CST$table[,-c(5:7,13)],2)
sii.CST$sii
## Example C.2 from ANSI S3.5-1997 Annex C[ANSI S3.5-1997＃示例C.2附件C]
sii.C2 <- sii(
speech = rep(54.0, 18),
noise = c(40.0, 30.0, 20.0, rep(0, 18-3) ),
threshold= rep(0.0, 18),
method="one-third"
)
sii.C2$table[1:3,1:8]
sii.C2
## Interpolation example, for 8 frequencies using NU6 importance[＃插值例如，对于8个频率使用NU6重要性]
## weight, default values for noise.[＃重量，噪音的默认值。]
sii.left <- sii(
speech="raised",
threshold=c(25,25,30,35,45,45,55,60),
freq=c(250, 500, 1000, 2000, 3000, 4000, 6000, 8000),
method="critical",
importance="NU6",
interpolate=TRUE
)
sii.left
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-30 02:15:28
