emuR (version 0.1.7)

AddListRemoveLevelDefinitions: Add / List / Remove level definition to / of / from emuDB

Description

Add / List / Remove database operation functions for level definitions. A level is a more general term for what is often referred to as a "tier". It is more general in the sense that people usually expect tiers to contain time information. Levels can either contain time information if they are of the type "EVENT" or of the type "SEGMENT" but are timeless if they are of the type "ITEM". For more information on the structural elements of an emuDB see vignette(emuDB). Note that a level cannot be removed, if it contains instances of annotation items or if it is linked to another level.

Usage

add_levelDefinition(emuDBhandle, name, type)
list_levelDefinitions(emuDBhandle)
remove_levelDefinition(emuDBhandle, name)

Arguments

emuDBhandle

emuDB handle as returned by load_emuDB

name

name of level definition

type

type of level definition ("SEGMENT","EVENT","ITEM")

Examples

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

# add level called "Phonetic2" to the ae emuDB
# that could for example contain the transcriptions of a second annotator
add_levelDefinition(emuDBhandle = ae,
                    name = "Phonetic2",
                    type = "SEGMENT")
                    
# list level definition of ae emuDB
list_levelDefinitions(emuDBhandle = ae)

# remove newly added level definition
remove_levelDefinitions(emuDBhandle = ae,
                        name = "Phonetic2")