convert_TextGridCollection {emuR} | R Documentation |
Convert a TextGridCollection (e.g. .wav & .TextGrid files) to emuDB
Description
Converts a TextGridCollection to an emuDB by searching a given directory for .wav & .TextGrid files (default
extensions) with the same base name. First, the function generates a file pair list
containing paths to files with the same base
name. It then generates an emuDB DBconfig based on the first TextGrid in this list which specifies
the allowed level names and types in the new emuDB. After this it converts all file pairs to the new format,
checking whether they comply to the newly generated database configuration. For
more information on the emuDB format see vignette{emuDB}
.
Note that since Praat TextGrids do not permit explicit hierarchical structures, the created emuDB does not contain
any links or link definitions. You can however use the autobuild_linkFromTimes
function after the conversion process
to automatically build a hierarchal structure.
Usage
convert_TextGridCollection(
dir,
dbName,
targetDir,
tgExt = "TextGrid",
audioExt = "wav",
tierNames = NULL,
verbose = TRUE
)
Arguments
dir |
path to directory containing the TextGridCollection (nested directory structures are permitted as the function recursively searches through directories, generating the session names from dir. structure) |
dbName |
name given to the new emuDB |
targetDir |
directory where to save the new emuDB |
tgExt |
extension of TextGrid files (default=TextGrid, meaning file names of the form baseName.TextGrid) |
audioExt |
extension of audio files (default=wav, meaning file names of the form baseName.wav) |
tierNames |
character vector containing names of tiers to extract and convert. If NULL (the default) all tiers are converted. |
verbose |
display infos & show progress bar |
Examples
## Not run:
##########################################################
# prerequisite: directory containing .wav & .TextGrid files
# (see \code{?create_emuRdemoData} how to create demo data)
# convert TextGridCollection and store
# new emuDB in folder provided by tempdir()
convert_TextGridCollection(dir = "/path/to/directory/",
dbName = "myTGcolDB",
targetDir = tempdir())
# same as above but this time only convert
# the information stored in the "Syllable" and "Phonetic" tiers
convert_TextGridCollection(dir = "/path/to/directory/",
dbName = "myTGcolDB",
targetDir = tempdir(),
tierNames = c("Syllable", "Phonetic"))
## End(Not run)