Learn R Programming

⚠️There's a newer version (2.5.0) of this package.Take me there.

emuR - Main package of the EMU Speech Database Management System

The emuR package provides the next iteration of the EMU Speech Database Management System (EMU-SDMS) with database management, data extraction, data preparation and data visualization facilities. It also contains a server that is intended to host databases in the emuDB format (see vignette('emuDB_intro')) to the EMU-webApp (http://ips-lmu.github.io/EMU-webApp/). The querying of annotations is performed using EMU's own EQL2 (EMU Query Language Version 2).

This package is part of the next iteration of the EMU Speech Database Management System which aims to be as close to an all-in-one solution for generating, manipulating, querying, analyzing and managing speech databases as possible. For an overview of the system please see http://ips-lmu.github.io/EMU.html and/or https://www.sciencedirect.com/science/article/pii/S0885230816302601 .

Installation

to install the current CRAN release simply call:

install.packages("emuR")

As this also installs all of the dependencies (incl. the wrassp package) this is the only installation step necessary to install the EMU-SDMS on your system. The only other requirement of the EMU-SDMS is a modern web browser (Chrome (recommended!) / Firefox / ...) which most people should already have on their systems.

Quick start

For more information see the The EMU-SDMS Manual

For Developers / Beta-Testers

Installation (two alternative methods)

either download & extract the package from GitHub. Then install it with the following command:

install.packages("path/to/emuR", repos = NULL, type="source")

or install the latest development version from GitHub (preferred method):

library(devtools)
install_github("IPS-LMU/emuR", build_vignettes = TRUE)

Copy Link

Version

Install

install.packages('emuR')

Monthly Downloads

509

Version

2.3.0

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/IPS-LMU/emuR

Homepage

https://ips-lmu.github.io/The-EMU-SDMS-Manual/

Maintainer

Raphael Winkelmann

Last Published

June 11th, 2021

Functions in emuR (2.3.0)

AddListRemoveLinkDefinition

Add / List / Remove linkDefinition to / of / from emuDB

SetGetRemoveLegalLabels

Set / Get / Remove legal labels of attributeDefinition of emuDB

AddListRemoveSsffTrackDefinition

Add / List / Remove ssffTrackDefinition to / from / of emuDB

AddListRemoveAttrDefLabelGroup

Add / List / Remove labelGroup to / of / from attributeDefinition of emuDB

SetGetSignalCanvasesOrder

Set / Get signalCanvasesOrder of / to / from emuDB

AddListRemoveLabelGroup

Add / List / Remove global labelGroup to / of / from emuDB

SetGetlevelCanvasesOrder

Set / Get level canvases order of emuDB

AddListRenameRemoveAttributeDefinitions

Add / List / Rename / Remove attribute definition to / of / from emuDB

AddListRemoveLevelDefinitions

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

AddListRemovePerspective

Add / List / Remove perspective to / of / from emuDB

Create an Emu trackdata object

A method of the generic function by for objects of class \'trackdata\'

EPG-compressed trackdata from the segment list coutts

Vector of word label from the segment list coutts

Convert Hertz to Bark and Bark to Hertz

cbind.trackdata

A method of the generic function cbind for objects of class \'trackdata\'

Three-columned matrix

Differentiation of tracks

Segment list, same as coutts but at a slower speech rate

autobuild_linkFromTimes

Autobuild links between two levels using their time information

Plot digital sinuoids.

Build trackdata objects from the output of by()

as.matrix.emusegs

as.matrix.emusegs

Trackdata of acoustic waveforms from the segment list coutts

bayesian.metric

bayesian metric

Function to extract a vector or matrix from EMU-Trackdata at a single time point of to create another EMU-trackdata object between two times.

Function to convert an object into an object of class 'spectral'.

EPG-compressed trackdata from the segment list coutts2

Function to plot a digital sinusoid and the circle from which it is derived.

Smooth the data in a trackdata object.

create_spectrogram_image_as_raster

Create spectrogram image as raster

create_emuRdemoData

Create demo data for the emuR package

Produce a classification plot from discriminant or SVM modelling

class method bind data

convert_legacyEmuDB

Convert legacy EMU database to the emuDB format

time signal times

Create empty emuDB

convert_txtCollection

Converts a collection of audio files and plain text transcriptions into an emuDB

Add files to emuDB

get.trackkeywrd

get trackkeywrd

List files of emuDB

Get trackdata from loaded emuDB

Discrete Cosine Transformation

Spectral vector of a single E vowel produced by a male speaker of Standard North German.

Subfunction of cen

convert_BPFCollection

Convert a Bas Partitur File Collection (audio and BAS Partitur files) to an emuDB

Duration of trackdata elements

Extract a subset of data from a trackdata object

Calculate ellipse coordinates

convert_TextGridCollection

Convert a TextGridCollection (e.g. .wav & .TextGrid files) to emuDB

apply a function to each part of a trackdata object

export_seglistToTxtCollection

Exports a segment list to txt collection

F0 track data for segment list demo.vowels

Function to dB-normalise spectral objects

make a EMU legend

Segment list of dipththongs, two speakers one male, one female , Standard North German, read speech from database kielread

Vector of word label from the segment list coutts2

segment list type

Read matrix data from a file

F0 track data for segment list demo.vowels

normalize_length

Normalize length of segments contained in a data.frame like object returned by get_trackdata

Function that applies a function to an EMU spectral object

Formant track data for segment list demo.vowels

Plot ellipses for two-dimensional data (DEPRECATED see below)

convert_wideToLong

convert tracks of a tibble trackdata object to the long form

Test whether an object is an Emu trackdata object

A method of the generic function dim for objects of class 'trackdata'

rms Data to coutts segment list

Segment list of words, read speech, female speaker of Australian English from database epgcoutts

import_mediaFiles

Import media files to emuDB

Trackdata of acoustic waveforms from the segment list coutts2

Formant track data for segment list demo.vowels

Get labels / utterances from segment list

Duration of segments (NOTE: does not work for new default resultType = "tibble" of query())

Matrix of formant data extracted at the temporal midpoint from the segment list vowlax.

Segment list of vowels in a d d context isolated word speech, one male speaker of Australian English from database isolated.

get a EMU color

Expand trackdata

delete_itemsInLevel

Delete items programmatically

Vector of phonetic labels from the segment list engassim: nK = nk,ng , sK = sk,sg

create_emuRtrackdata

create emuRtrackdata object

create_itemsInLevel

Create new items programmatically

Vector of labels preceding the vowels from the segment list vowlax

Vector of phoneme labels from the segment list dip

dimnames.trackdata

Dimnames of trackdata object

Trackdata of formants from the segment list dip

Vector of word labels from segment list wordlax

Emu segment list

Trackdata of formants from the segment list isol

replace_itemLabels

Replace item labels

Vector of speaker labels from the segment list dip

mahalanobis.metric

mahalanobis metric

duplicate_level

Duplicate level

A function to plot one or more columns of EMU-trackdata as a function of time (DEPRECATED see below)

Find the time and position of a data element.

create links between items

Requery sequential context of segment list in an emuDB

Label each data sample

Function for specifying color, linetype, and line-widths in EMU plotting functions.

Electropalatographic contact indices

Calculate locus equations for two-dimensional data

Emu track data for a rms track for segment list demo.all

Function for inter-converting between decibels and a linear scale

Segment list of a sequence of syllable final n or N preceding k or g , isolated words single speaker, Australian English female from database epgassim.

Electropalatographic centre of gravity

Emu segment List

Vector of word labels from the segment list engassim.

get.time.element

Get data for a given time

list_sampleRates

List sample rates of media and annotation (_annot.json) files

Function to calculate statistical moments

emuR segment list

Sort emuRsegs segment list by session, bundle and sample_start

Requery hierarchical context of a segment list in an emuDB

print.emuRtrackdata

Print emuRtrackdata object

emusegs.database

emusegs database

Extract a subset of data from a trackdata object

emuR track data object

Normalise speech data

runBASwebservice_g2pForTokenization

Tokenizes an orthographic transcription.

EPG-compressed trackdata from the segment list engassim

rbind.trackdata

A method of the generic function rbind for objects of class trackdata

Vector of vowel phoneme labels from the segment list isol

export_BPFCollection

Exports an emuDB into a BAS Partitur File (BPF) Collection

runBASwebservice_g2pForPronunciation

Creates canonical pronunciation attributes for a tier of tokenized orthographical words.

export_TextGridCollection

Export annotations of emuDB to TextGrid collection

emuR - Main Package of the EMU Speech Database Management System

Vector of word labels from the segment list fric.

Plot a grey-scale image of palatographic data.

mu.linetype.get

mu linetype get

Get the track times from EMU trackdata objects

Find common elements in vectors

Trackdata of RMS energy from the segment list vowlax

Plot palatographic data

Make an Emu segment list from the various components

Sum contacts in palatograms.

print.trackdata

print trackdata

Function to find the column number corresponding to frequencies of a spectral object

Segment list of four Polish homorganic fricatives from database epgpolish.

Segment list of word-medial s or z one male speaker of Standard North German, read speech from database kielread.

Find the inter-euclidean distance for a data matrix

Spectral trackdata object from the segment list fric.

Modify one of the components of an Emu segment list

runBASwebservice_maus

Runs MAUS webservice to create a phonetic segmentation

Function to test whether the object is of class "spectral"

Rename bundles in emuDB

List sessions of emuDB

Print emuRsegs segment list

write_bundleList

write bundleList

Convert Hz to the mel scale

Calculate the coefficients of a parabola

Make emuDB segment list

runBASwebservice_pho2sylCanonical

Adds syllabified word labels to a word level that already contains canonical pronunciations.

summary.emusegs

summary emusegs

Segment list of four lax vowels, read speech, one male and one female speaker of Standard North German from database kielread.

Train a Gaussian Model

Vector of RMS energy values at the temporal midpoint extracted at the temporal midpoint from the segment list vowlax

Calculate mahalanobis distances

Plot spectra from EMU spectral objects

Spectral matrix centred at the temporal midpoint of the vowels from the segment list vowlax.

Vector of labels from the segment list fric

Obtain a three-dimensional palatographic array

resample_annots

Resample annotations (_annot.json) files of emuDB

Function to shift the elements of a vector.

Classify using Mahalanobis distance

Randomise or Reverse items in a segment list

runBASwebservice_all

Runs several BAS webservices, starting from an orthographic transcription

Trackdata of formants from the segment list vowlax

List bundles of emuDB

Perform linear time normalisation on trackdata.

summary.emuDBhandle

Print summary of loaded EMU database (emuDB).

runBASwebservice_chunker

Creates a chunk segmentation using the webservice Chunker.

summary.trackdata

summary trackdata

function to find the frequencies of a spectral object

EPG-compressed trackdata from the segment list polhom

Write out ESPS-style label files

read_bundleList

read bundleList

Vector of fundamental frequency extracted at the temporal midpoint from the segment list vowlax.

runBASwebservice_minni

Creates a rough phonetic segmentation by running the phoneme decoder webservice MINNI.

Performance (hit rate) of a confusion matrix

A method of the generic function by for objects of class \'trackdata\'

Produces time-series plots from trackdata

Split a string into words.

Converts degrees to radians

Expand spectral

runBASwebservice_pho2sylSegmental

Creates a syllable segmentation on the basis of a phonetic segmentation.

update_itemsInLevel

Update items programmatically

Serve EMU database to EMU-webApp

Function to convert between Hertz and Radians

Start and end times for EMU segment lists and trackdata objects

Sort matrix by label

Vector of speaker labels from the segment list vowlax.

Vector of labels following the vowels from the segment list vowlax

Create an Emu segment list from a file

Track data object

Vector of phonetic labels from the segment list polhom

Trackdata of fundamental frequency from the segment list vowlax

Data frame of various parameters and labels from the segment list vowlax

Vector of word labels from the segment list vowlax.

Write an Emu segment list to a file

Vector of phoneme labels from the segment list vowlax

Calculate gradient summary information for trackdata

track.gradinfo.sub

track gradinfo sub