export_TextGridCollection: Export annotations of emuDB to TextGrid collection

Description Usage Arguments See Also Examples

View source: R/emuR-export_TextGridCollection.R

Description

Exports the annotations of an emuDB to a TextGrid collection (.TextGrid and .wav file pairs). To avoid naming conflicts and not to loose the session information, the session structure of the database is kept in place (i.e. the TextGrid collection will have sub-folders that are named as the sessions were). Due to the more complex annotation structure modeling capabilities of the EMU-SDMS system, this export routine has to make several compromises on export which can lead to information loss. So use with caution and at own risk as reimporting the exported data will mean that not all information can be recreated! The main compromises are:

Usage

1
2
3
4
5
6
7
8
9
export_TextGridCollection(
  emuDBhandle,
  targetDir,
  sessionPattern = ".*",
  bundlePattern = ".*",
  attributeDefinitionNames = NULL,
  timeRefSegmentLevel = NULL,
  verbose = TRUE
)

Arguments

emuDBhandle

emuDB handle object (see load_emuDB)

targetDir

directory where the TextGrid collection should be saved

sessionPattern

A regular expression pattern matching session names to be exported from the database

bundlePattern

A regular expression pattern matching bundle names to be exported from the database

attributeDefinitionNames

list of names of attributeDefinitions that are to be exported as tiers. If set to NULL (the default) all attribute definitions will be exported as separate tiers.

timeRefSegmentLevel

parameter passed into query function. (set time segment level from which to derive time information. It is only necessary to set this parameter if more than one child level contains time information and the queried parent level is of type ITEM.)

verbose

Show progress bars and further information

See Also

load_emuDB

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
## Not run: 

##################################
# prerequisite: loaded ae emuDB 
# (see ?load_emuDB for more information)

## Export all levels
export_TextGridCollection(ae, "/path/2/targetDir")


## End(Not run)

emuR documentation built on June 11, 2021, 5:10 p.m.