AudioTools
Extract
extract a piece of an audio recording
Calling Sequence
Parameters
Description
Examples
Extract(audArray, timeRange)
audArray
-
the Array, Vector, or Matrix containing the audio data
timeRange
the time period to extract
The Extract command extracts a piece of an audio recording and returns a new audio object containing the extracted piece.
The audArray parameter must be a dense, rectangular, one or two dimensional Array, Vector, or Matrix with datatype=float[8].
The timeRange parameter can be either a number, or a range of numbers. In either case, positive values refer to times relative to the beginning of audArray, whereas negative values refer to times relative to the end of audArray.
If a number is specified, Extract extracts that many seconds from the beginning (if positive) or end (if negative) of audArray.
If a range is specified, the data between those two points in time is extracted. Negative values are treated as described above.
Because Extract can only work to the nearest whole sample, the precise duration of the result may be slightly more or less than what was specified by timeRange.
audiofile≔cat⁡kernelopts⁡datadir,/audio/stereo.wav:
with⁡AudioTools:
aud≔Read⁡audiofile
aud≔Sample Rate22050File FormatPCM File Bit Depth8Channels2Samples/Channel19962Duration0.90531⁢s
dur≔evalf⁡Duration⁡aud
dur≔0.9053061224
middle≔Extract⁡aud,0.1..−0.1
middle≔Sample Rate22050File FormatPCM File Bit Depth8Channels2Samples/Channel15553Duration0.70535⁢s
evalf⁡Duration⁡middle
0.7053514739
last_quarter_sec≔Extract⁡aud,−0.25
last_quarter_sec≔Sample Rate22050File FormatPCM File Bit Depth8Channels2Samples/Channel5512Duration0.24998⁢s
evalf⁡Duration⁡last_quarter_sec
0.2499773243
See Also
Array
AudioTools[Duration]
Matrix
Vector
Download Help Document