AudioAnnotate

AudioAnnotate[audio,prop]

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

AudioAnnotate[audio,namespec]

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,{name1->spec1,}] 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:
  • {roi1val1,}a list of regions and values
    {roi1,roi2,}a list of regions
    TimeSeries[]a time series
    critany criterion supported by AudioIntervals
  • Any region roii can be a time t or a time interval {t1,t2} or an Interval object.
  • Annotation values vali can be any arbitrary expression.

Examples

open allclose all

Basic Examples  (2)

Annotate an Audio object with explicit annotations:

Retrieve annotations using AudioAnnotationLookup:

Automatically compute annotations for an Audio object:

Retrieve all the annotation labels using AnnotationKeys:

Retrieve the annotation using AnnotationValue:

Scope  (5)

Compute an annotation using an AudioLocalMeasurements property:

Compute an annotation using an AudioIntervals property:

Compute an annotation using an AudioIntervals criterion:

Compute an annotation using the "Transients" preset:

Compute multiple properties at a single time:

Retrieve all of the annotations:

Introduced in 2019
 (12.0)
 |
Updated in 2020
 (12.1)