Scale data and play as sound
soundsc( scales the values of
y to fit in the range from –1 to 1, and then
sends the data to the speaker at the default sample rate of 8192 Hz. By first
scaling the data,
soundsc plays the audio as loudly as
possible without clipping. The mean of the dynamic range of the data is set to
Play Example Data at Default Sample Rate
Load the example file
gong.mat, which contains example data
y and sample rate
Fs, and play the audio.
load gong.mat soundsc(y)
Play Example Data at Specified Sample Rate
Play an excerpt from Handel's Hallelujah Chorus at twice the recorded sample rate.
load handel.mat soundsc(y,2*Fs)
Play Example Data with Specified Bits per Sample
load handel.mat nBits = 16; soundsc(y,Fs,nBits);
MATLAB® plays the scaled audio with a bit depth of 16 bits per sample, if this bit depth is supported on your system.
Scale Selected Audio Data
Play an excert from Handel's Hallelujah Chorus at 70% of its original volume.
load handel.mat yRange = [-0.7,0.7]; soundsc(y,yRange);
Fs — Sample rate
8192 (default) | positive scalar
Sample rate in hertz (Hz), specified as a positive scalar.
Valid values of the sample rate depend on the audio hardware of your system. Typical sample rates supported by most setups are 8000, 11,025, 22,050, 44,100, 48,000, 96,000, and 192,000 Hz.
yRange — Range of audio data to scale
Range of audio data to scale, specified as a two-element vector of the
are the lower and
upper limits of the range, respectively. Values in
that are scaled beyond [–1, 1] are clipped when played back on a sound
If you do not specify
yRange, it defaults to the
is the maximum entry
In MATLAB® Online™ or MATLAB Web App Server™,
nBits. Instead, it plays audio data using the default number of bits per sample of the output audio device.
soundscfunction supports sound devices on all Windows® and most UNIX® platforms.
soundscin MATLAB Online and MATLAB Web App Server is supported in Google Chrome™.
Security Considerations When Using MATLAB Online or MATLAB Web App Server: When using
soundscin MATLAB Online or MATLAB Web App Server, certain features and settings help you keep control of your privacy.
To reduce the likelihood of unwanted applications using your microphone, turn off automatic access to your audio device. You can change these settings at any time. After granting permission to a website once, your browser may be able to access your microphone automatically for that site on future visits. Use the browser settings for Google Chrome to revoke access for specific sites after you have initially allowed access.
You can also access the MATLAB Online website or MATLAB Web App Server using the private browsing mode in Google Chrome. When you do this, Chrome™ automatically asks you for permission to access your microphone every time you open the MATLAB Online site or MATLAB Web App Server and run
soundsc, regardless of your browser settings.
Introduced before R2006a