write.audacity: Audacity audio markers export

View source: R/seewave.r

write.audacityR Documentation

Audacity audio markers export

Description

Write audio markers to be imported by Audacity.

Usage

write.audacity(x, filename)

Arguments

x

a data frame with the three or five colums, see details.

filename

name of the .txt file. (by default the name of x).

Details

The input x object should be a data frame with two or three columns depending on whether the markers include frequency limits or not :

  • time limits only:

    1. text label of each marker,

    2. time marker of the beginning of each marker,

    3. time marker of the end of each marker.

  • time and frequency limits:

    1. text label of each marker,

    2. time marker of the beginning of each marker,

    3. time marker of the end of each marker,

    4. lower frequency limit of each marker,

    5. higher frequency limit of each marker.

Value

A .txt file is generated to be imported as a markers in Audacity.

Note

Naming the columns of x is not necessary.

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

read.audacity

Examples

## 3 markers, time only
t1 <- c(9.2, 16.2, 24.4)
t2 <- c(11.7, 18.7, 26.9)
label <- c("a", "b", "c")
df <- data.frame(label, t1, t2)
write.audacity(df, filename="test-time.txt")
## 3 markers, time and frequency
t1 <- c(9.4, 15.2, 24.9)
t2 <- c(10.54, 16.6, 26.1)
f1 <- c(1703.4, 3406.8, 1608.8)
f2 <- c(7476.2, 8517.2, 5110.3)
label <- c("a", "b", "c")
dff <- data.frame(label, t1, t2, f1, f2)
write.audacity(dff, filename="test-time-frequency.txt")
## delete files
unlink(c("test-time.txt", "test-time-frequency.txt"))

seewave documentation built on Oct. 19, 2023, 5:07 p.m.