Annotations
Data standards
-
Bioacoustic and Ecoacoustic Data in Audiovisual Core Talk at SPNHC-TDWG 2024 Conference (Okinawa, Japan)
Annotations in wavesurfer.js
- wavesurfer-annotations Displays annotations as time regions on the waveform and, when frequency bounds are available, as boxes on the spectrogram. It accepts Audiovisual Core terms or plain annotation objects.
Related work
- Making wavesurfer.js faster for long, heavily annotated recordings Covers performance changes to wavesurfer.js and the annotations plugin, including a layout optimization that skips boxes that have not moved (about 2.2–2.4 times faster).
Tools for handling annotations in R
These functions define a new object class Annotation and associated functions that can be used to store, manipulate, edit and save annotations.
-
Annotationclass insonicscrewdriverDefines theAnnotationclass. -
annotation()insonicscrewdriverCreates anAnnotationobject. -
merge_annotations()insonicscrewdriverUsed to merge overlapping or adjacentAnnotationobjects. By default it merges only annotations made by the same person or software, so that each merged annotation is credited to the right one. -
sort_annotations()insonicscrewdriverUsed to sort a list ofAnnotationobjects. -
AnnotationList2DataFrame()insonicscrewdriverConverts a list ofAnnotationobjects to a data frame, with a column for each metadata field.
An Annotation records who made it and when as identifiedBy and dateIdentified, the Audiovisual Core terms dwc:identifiedBy and dwc:dateIdentified for a region of interest. Its source says where it came from, such as the software or the collection. The functions below that read annotations fill these in where the source records them: the annotator in audioBlast, the user in AOEF, the volunteer in FlyTunes, and the model and its version in BirdNET.
Sources of annotations
-
birdNetAnalyse()insonicscrewdriverOutputs identifications asAnnotationobjects, or optionally as a data frame. -
readAudacityLabels()insonicscrewdriverReads an Audacity label file, including any frequency limits, asAnnotationobjects. -
audioblast()insonicscrewdriverFetches annotations from the audioBlast annomate module asAnnotationobjects, withoutput="Annotation". -
wavCues()insonicscrewdriverReads the cue points and labelled regions that audio editors save in a wave file asAnnotationobjects. -
readAOEF()insonicscrewdriverReads a file in the Acoustic Objects Exchange Format (AOEF), the JSON format of the soundevent Python package and of projects exported from the Whombat annotation tool, asAnnotationobjects. -
flytunes_annotations()inNHMDEOutputsAnnotationobjects from Zooniverse exports of the FlyTunes project.
Saving annotations
-
writeAudacityLabels()insonicscrewdriverWrites a list ofAnnotationobjects as a label file for the audio editor Audacity. -
writeAnnotationWave()insonicscrewdriverSaves the time region of eachAnnotationobject as a wave file. -
writeAOEF()insonicscrewdriverWrites a list ofAnnotationobjects as an AOEF file, which soundevent reads and Whombat imports as an annotation project.
Miscellany
- Hunting performance in R Investigates the performance of annotation related functionality in
sonicscrewdriver.