filerms

Return soundfile peak RMS amplitude.

Synopsis

rms_amp = filerms(“filename”)

Description

filerms returns the peak RMS amplitude of the soundfile filename. filename may be an absolute or relative pathname to the soundfile. This command does not require that the soundfile be previously opened by the rtinput command.

RMS (Root Means Squared) amplitudes are a standard way of measuring sound level. The value is calculated by squaring the value of every sample, summing those values, taking the average (that’s the “means squared”), and then taking the square root of that number.

Arguments

• “filename”
  A string representing the name of the soundfile to be queried. It may be an absolute or relative pathname to the soundfile. If it is relative, then it will be relative to the directory where the CMIX command was invoked.

Examples

rms_amp = filerms("somesoundfile")

See Also

CHANS, DUR, PEAK, SR, filechans, filedur, filepeak, filesr, rtinput