read.audacity {seewave}R Documentation

Audacity audio markers import

Description

Read audio markers as exported by Audacity.

Usage

read.audacity(file, format)

Arguments

file

A .txt file produced by Audacity when exporting time or time x frequency markers.

format

The format of the file name that will appear in the value, that is in the first column of the data frame returned. if "dir" then the full path to the file is returned, if "base" only the base name of the file is returned.

Details

Audacity opens the possibility to annotate sound files with a marker channel. These markers can be exported as .txt files. The function read.audacity import such .txt files whether they contain time markers or time x frequency markers.

Value

A data.frame. The size of the data.frame differs whether the .txt file contains time markers or time x frequency markers.
For time markers, the data.frame contains 4 columns:

  1. file returning the name of the input file either with the full path or with the base name only (see argument format),

  2. label the text label,

  3. t1 the start time in seconds,

  4. t2the end time in seconds.

For time x frequency markers, the data.frame contains 6 columns:

  1. file returning the name of the input file either with the full path or with the base name only (see argument format),

  2. label the text label,

  3. t1 the start time in seconds,

  4. t2 the end time in seconds,

  5. f1 the lower frequency in Hz,

  6. f2 the upper frequency in Hz.

Author(s)

Jerome Sueur

References

Audacity is a free software distributed under the terms of the GNU General Public License.
Web site: https://www.audacityteam.org/

See Also

write.audacity

Examples

## Not run: 
## If 'markers.txt' is an export of Audacity markers
x <- read.audacity("markers.txt")

## End(Not run)

[Package seewave version 2.2.3 Index]