emuR (version 1.0.0)

runBASwebservice_maus: Runs MAUS webservice to create a phonetic segmentation


This function calls the BAS webservice MAUS to generate a phonemic segmentation. It requires a word-tokenized tier with a SAMPA pronunciation, which can be generated by the function runBASwebservice_g2pForPronunciation. This function requires an internet connection.


runBASwebservice_maus(handle, canoAttributeDefinitionName, language,
  mausAttributeDefinitionName = "MAU", chunkLevel = NULL,
  turnChunkLevelIntoItemLevel = TRUE, params = NULL,
  perspective = "default", patience = 0, resume = FALSE, verbose = TRUE)



emuDB handle


name of the attribute (not level!) containing the SAMPA word pronunciations. If this attribute resides on a segment level, the segment time information is used as a presegmentation. If it is an item level, no assumption is made about the temporal position of segments.


language(s) to be used. If you pass a single string (e.g. "deu-DE"), this language will be used for all bundles. Alternatively, you can select the language for every bundle individually. To do so, you must pass a data frame with the columns session, bundle, language. This data frame must contain one row for every bundle in your emuDB. Up-to-date lists of the languages accepted by all webservices can be found here: https://clarin.phonetik.uni-muenchen.de/BASWebServices/services/help


attribute name for the MAUS segmentation


if you have a chunk segmentation level, you can provide it to improve the speed and accuracy of MAUS. The chunk segmentation level must be a segment level, and it must link to the level of canoAttributeDefinitionName.


if TRUE, and if a chunk level is provided, the chunk level is converted into an ITEM level after segmentation


named list of parameters to be passed on to the webservice. It is your own responsibility to ensure that these parameters are compatible with the webservice API (see https://clarin.phonetik.uni-muenchen.de/BASWebServices/services/help). Some options accepted by the API (e.g. output format) cannot be set when calling a webservice from within emuR, and will be overridden.


the webApp perspective that the new level will be added to. If NULL, the new level is not added to any perspectives.


If a web service call fails, it is repeated a further n times, with n being the value of patience. Must be set to a value between 0 and 3.


If a previous call to this function has failed (and you think you have fixed the issue that caused the error), you can set resume=TRUE to recover any progress made up to that point. This will only work if your R temporary directory has not been deleted or emptied in the meantime.


Display progress bars and other information


All necessary level, link and attribute definitions are created in the process.

See Also

Other BAS webservice functions: runBASwebservice_all, runBASwebservice_chunker, runBASwebservice_g2pForPronunciation, runBASwebservice_g2pForTokenization, runBASwebservice_minni, runBASwebservice_pho2sylCanonical, runBASwebservice_pho2sylSegmental