WOLFRAM

Wolfram Language & System Documentation Center

AudioAnnotationLookup[audio]

gives all annotations associated to audio.

AudioAnnotationLookup[audio,tags]

gives the annotations specified by tags.

AudioAnnotationLookup[audio,tagsselector]

gives a selection of annotations using selector.

AudioAnnotationLookup[audio,tagsselector,format]

formats each annotation element according to format.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
See Also
Related Guides
History
Cite this Page

AudioAnnotationLookup

AudioAnnotationLookup[audio]

gives all annotations associated to audio.

AudioAnnotationLookup[audio,tags]

gives the annotations specified by tags.

AudioAnnotationLookup[audio,tagsselector]

gives a selection of annotations using selector.

AudioAnnotationLookup[audio,tagsselector,format]

formats each annotation element according to format.

Details

  • Annotations are used to store and manipulate comments or local metadata for Audio objects.
  • AudioAnnotationLookup can be used to select and retrieve annotations at specific locations or based on desired criteria.
  • Tags specification tags can be any of the following:
  • Allall tags
    "tag"annotations labeled as "tag"
    {"tag1","tag2",…}annotations labeled as any specified "tagi"
  • The selector can be any of the following:
  • tannotations present at time t
    Interval[{t1,t2}]annotations intersecting with the time interval
    fan arbitrary function applied to each element
    {selector1,selector2,…}a list of selector specifications
  • The arbitrary function f is applied to the association corresponding to each annotation element.
  • Use AudioAnnotate to automatically compute and store audio annotations.

Examples

open all close all

Basic Examples  (2)

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];res = AudioAnnotate[a, "tag" -> {.5 -> "val", {1, 1.5} -> "val2"}];

Retrieve all annotations using AudioAnnotationLookup:

Wolfram Language code: AudioAnnotationLookup[res]

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];res = AudioAnnotate[a, {"tag1" -> {.5 -> "v11", {1, 1.5} -> "v12"}, "tag2" -> {.1 -> "v21", {.7, 1.5} -> "v22"}}];

Retrieve an annotation with a specific tag:

Wolfram Language code: AudioAnnotationLookup[res, "tag1"]

Scope  (6)

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&), "Inaudible"}];

Select all annotations that intersect with the time .2:

Wolfram Language code: AudioAnnotationLookup[a, All -> .2]//Column

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&), "Inaudible"}];

Select all annotations between times .1 and 1:

Wolfram Language code: AudioAnnotationLookup[a, All -> Interval[{.1, 1}]]//Column

Select all annotations belonging to the tag "Loud" between times .1 and 1:

Wolfram Language code: AudioAnnotationLookup[a, "Loud" -> Interval[{.1, 1}]]

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&)}];

Select all annotations using a custom function:

Wolfram Language code: AudioAnnotationLookup[a, All -> (Quiet[#[[2]] > .4]&)]

If multiple selection criteria are used, an annotation element is selected if any of them return True:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&), "Inaudible"}];
Wolfram Language code: AudioAnnotationLookup[a, All -> {#[[1]] > .6&, #[[2]] > .4&}]

Construct a single custom function if other behaviors are needed:

Wolfram Language code: AudioAnnotationLookup[a, All -> {#[[1]] > .6 && #[[2]] > .4&}]

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&), "Max"}];

Format the output annotation as a list of intervals:

Wolfram Language code: AudioAnnotationLookup[a, "Transients", "Intervals"]

Format the output annotation as a TimeSeries:

Wolfram Language code: AudioAnnotationLookup[a, "Max", "TimeSeries"]

Annotate an Audio object:

Wolfram Language code: a = Import["ExampleData/rule30.wav"];a = AudioAnnotate[a, {"Transients", "Loud" -> (#RMSAmplitude > .08&), "Max"}];

Format the output annotation using a custom function:

Wolfram Language code: AudioAnnotationLookup[a, "Transients", List@@#&]
Wolfram Research (2019), AudioAnnotationLookup, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html.

Text

Wolfram Research (2019), AudioAnnotationLookup, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html.

CMS

Wolfram Language. 2019. "AudioAnnotationLookup." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html.

APA

Wolfram Language. (2019). AudioAnnotationLookup. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html

BibTeX

@misc{reference.wolfram_2026_audioannotationlookup, author="Wolfram Research", title="{AudioAnnotationLookup}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_audioannotationlookup, organization={Wolfram Research}, title={AudioAnnotationLookup}, year={2019}, url={https://reference.wolfram.com/language/ref/AudioAnnotationLookup.html}, note=[Accessed: 12-June-2026]}