AudioAnnotate

✖
`AudioAnnotate`

[Experimental]

✖

AudioAnnotate[audio,prop]

computes the property prop and adds it as an annotation to audio.

✖

AudioAnnotate[audio,namespec]

adds an annotation with the specified name and values spec to audio.

Details

AudioAnnotate is used to store and manipulate annotations for Audio objects.
With AudioAnnotate[audio,…], annotations will be populated with the computed or specified annotations.
Use AudioAnnotationLookup to access and modify annotations.
AudioAnnotate[audio,{name₁->spec₁,…}] can be used to add multiple annotations.
The property prop can be any of the properties supported by AudioLocalMeasurements.
Additional supported properties prop include:

	"Audible"	audible intervals, RMS amplitude above 0.01
	"Inaudible"	inaudible intervals, RMS amplitude less than or equal to 0.01
	"Loud"	louder intervals, data-dependent threshold
	"Quiet"	quieter intervals, data-dependent threshold
	"Transients"	times corresponding to the beginning of any event
	"VoiceActivity"	intervals with detected speech
	"VoiceInactivity"	intervals with no detected speech

Annotation value spec can be any of the following:

	{roi₁val₁,…}	a list of regions and values
	{roi₁,roi₂,…}	a list of regions
	TimeSeries[…]	a time series
	crit	any criterion supported by AudioIntervals

Any region roi_i can be a time t or a time interval {t₁,t₂} or an Interval object.
Annotation values val_i can be any arbitrary expression.

Examples

open allclose all

Basic Examples (2)Summary of the most common use cases

Annotate an Audio object with explicit annotations:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-xeud49

Retrieve annotations using AudioAnnotationLookup:

In[3]:=3

✖

https://wolfram.com/xid/0pu1cpen0k-mne89s

Out[3]=3

Automatically compute annotations for an Audio object:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-2rdekb

Retrieve all the annotation labels using AnnotationKeys:

In[2]:=2

✖

https://wolfram.com/xid/0pu1cpen0k-nbvo5l

Out[2]=2

Retrieve the annotation using AnnotationValue:

In[3]:=3

✖

https://wolfram.com/xid/0pu1cpen0k-0zdp5b

Out[3]=3

Scope (5)Survey of the scope of standard use cases

Compute an annotation using an AudioLocalMeasurements property:

In[3]:=3

✖

https://wolfram.com/xid/0pu1cpen0k-lyt8hm

Compute an annotation using an AudioIntervals property:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-yxs6f8

Out[1]=1

Compute an annotation using an AudioIntervals criterion:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-hsekl6

Out[1]=1

Compute an annotation using the "Transients" preset:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-4dacos

Out[1]=1

Compute multiple properties at a single time:

In[1]:=1

✖

https://wolfram.com/xid/0pu1cpen0k-n6juce

Retrieve all of the annotations:

In[2]:=2

✖

https://wolfram.com/xid/0pu1cpen0k-ofh4wm

Out[2]=2

Top