emuR (version 0.1.8)

get_trackdata: Get trackdata from loaded emuDB

Description

Extract trackdata information from a loaded emuDB that corresponds to the entries in a segment list.

Usage

get_trackdata(emuDBhandle, seglist = NULL, ssffTrackName = NULL, cut = NULL, npoints = NULL, onTheFlyFunctionName = NULL, onTheFlyParams = NULL, onTheFlyOptLogFilePath = NULL, nrOfAllocationRows = 10000, resultType = "trackdata", verbose = TRUE)

Arguments

emuDBhandle

emuDB handle as returned by load_emuDB

seglist

emuRsegs or emusegs object obtained by querying a loaded emuDB

ssffTrackName

The name of track that one wishes to extract (see list_ssffTrackDefinitions for the defined ssffTracks of the emuDB). If the parameter onTheFlyFunctionName is set, then this corresponds to the column name af the AsspDataObj (see wrasspOutputInfos[[onTheFlyFunctionName]]$tracks and wrasspOutputInfos). If the parameter onTheFlyFunctionName is set and this one isn't, then per default the first track listed in the wrasspOutputInfos is chosen (wrasspOutputInfos[[onTheFlyFunctionName]]$tracks[1]).

cut

An optional cut time for segment data, ranges between 0 and 1, a value of 0.5 will extract data only at the segment midpoint.

npoints

An optional number of points to retrieve for each segment or event. For segments this requires the cut parameter to be set; if this is the case, then data is extracted around the resulting cut time. For events data is extracted around the event time. If npoints is an odd number, the samples are centered around the cut-time-sample; if not, they are skewed to the right by one sample.

onTheFlyFunctionName

Name of wrassp function that will perform the on-the-fly calculation (see names(wrasspOutputInfos) for a list of all the signal processing functions wrassp provides)

onTheFlyParams

A pairlist of parameters that will be given to the function passed in by the onTheFlyFunctionName parameter. This list can easily be generated by applying the formals function to the on-the-fly function name and then setting the according parameter one wishes to change.

onTheFlyOptLogFilePath

Path to optional log file for on-the-fly function

nrOfAllocationRows

If this size limit of the data matrix is reached a further nrOfAllocationRows more rows will be allocated. As this allocation leads to a performance penalty one should consider increasing this number for large emuDBs.

resultType

Specify class of returned object. Either "emuRtrackdata" or "trackdata".

verbose

Show progress bars and further information

Value

If the cut parameter is not set (the default) an object of type trackdata or emuRtrackdata is returned. If cut is set and npoints is not, or the seglist is of type event and npoints is not set, a data.frame is returned.

Details

This function utilizes the wrassp package for signal processing and SSFF/audio file handling. It reads time relevant data from a given segment list (emuRsegs or emusegs), extracts the specified trackdata and places it into a trackdata object (analogous to the depricated emu.track). This function replaces the deprecated emu.track function. Note that a error is thrown if the bundles in the emuRsegs or emusegs object have in-homogeneous sampling rates as this will lead to inconsistent/erroneous trackdata or emuRtrackdata result objects. For more information on the structural elements of an emuDB see vignette{emuDB}.

See Also

formals, wrasspOutputInfos, trackdata, emuRtrackdata

Examples

## Not run: 
# 
# ##################################
# # prerequisite: loaded ae emuDB 
# # (see ?load_emuDB for more information)
# 
# # query loaded "ae" emuDB for all "i:" segments of the "Phonetic" level
# sl = query(emuDBhandle = ae, 
#            query = "Phonetic == i:")
# 
# # get the corresponding formant trackdata
# td = get_trackdata(emuDBhandle = ae, 
#                    seglist = sl, 
#                    ssffTrackName = "fm")
# 
# # get the corresponding F0 trackdata
# # as there is no F0 ssffTrack defined in the "ae" emuDB we will 
# # calculate the necessary values on-the-fly
# td = get_trackdata(emuDBhandle = ae, 
#                    seglist = sl, 
#                    onTheFlyFunctionName = "ksvF0")
#                    
# ## End(Not run)