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

Out of funding

Unfortunately, the EMU-SDMS is currently out of funding.

We at the IPS will do what we can to fix bugs, security issues or necessary adjustments to new versions of R; but we cannot currently work on new features or performance improvements.

We would be very glad if funding in academia allowed for more technical staff to maintain software used by the research community.

Introduction

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

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

465

Version

2.4.2

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Markus Jochim

Last Published

November 3rd, 2023

Functions in emuR (2.4.2)

bayes.lab

bayes lab
as.matrix.emusegs

as.matrix.emusegs
as.trackdata

Create an Emu trackdata object
autobuild_linkFromTimes

Autobuild links between two levels using their time information
bark

Convert Hertz to Bark and Bark to Hertz
cen.sub

Subfunction of cen
bayes.dist

bayes dist
classify

classify
bind

class method bind data
Slope.test

Slope Test
bayesplot

bayesplot
classplot

Produce a classification plot from discriminant or SVM modelling
closest

closest
convert_legacyEmuDB

Convert legacy EMU database to the emuDB format
coutts.rms

rms Data to coutts segment list
bayesian.metric

bayesian metric
convert_txtCollection

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

Add files to emuDB
bridge

Three-columned matrix
coutts2.l

Vector of word label from the segment list coutts2
coutts.epg

EPG-compressed trackdata from the segment list coutts
coutts2.sam

Trackdata of acoustic waveforms from the segment list coutts2
buildtrack

Build trackdata objects from the output of by()
dbtopower

Function for inter-converting between decibels and a linear scale
coutts.l

Vector of word label from the segment list coutts
create_itemsInLevel

Create new items programmatically
coutts.sam

Trackdata of acoustic waveforms from the segment list coutts
as.spectral

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

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

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

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

bind trackdata
bind.default

data binding
by.trackdata

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

Discrete Cosine Transformation
create_links

create links between items
dcut

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.
ddiff

Differentiation of tracks
cr

Plot digital sinuoids.
demo.all.f0

F0 track data for segment list demo.vowels
convert_wideToLong

convert tracks of a tibble trackdata object to the long form
create_emuDB

Create empty emuDB
coutts2

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

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

Extract a subset of data from a trackdata object
dextract.lab

Extract a subset of data from a trackdata object
coutts2.epg

EPG-compressed trackdata from the segment list coutts2
create_spectrogram_image_as_raster

Create spectrogram image as raster
distance

distance
create_emuRdemoData

Create demo data for the emuR package
crplot

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

Duplicate level
demo.all.fm

Formant track data for segment list demo.vowels
delete_itemsInLevel

Delete items programmatically
demo.all

Emu segment list
demo.vowels.f0

F0 track data for segment list demo.vowels
dip.l

Vector of phoneme labels from the segment list dip
dplot

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

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

duration
export_seglistToTxtCollection

Exports a segment list to txt collection
create_emuRtrackdata

create emuRtrackdata object
dapply

apply a function to each part of a trackdata object
emusegs.type

segment list type
dimnames.trackdata

Dimnames of trackdata object
export_BPFCollection

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

Function that applies a function to an EMU spectral object
emuRtrackdata

emuR track data object
dbnorm

Function to dB-normalise spectral objects
dip.spkr

Vector of speaker labels from the segment list dip
emusegs.query

emusegs query
export_TextGridCollection

Export annotations of emuDB to TextGrid collection
demo.all.rms

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

Function to find the column number corresponding to frequencies of a spectral object
demo.vowels.fm

Formant track data for segment list demo.vowels
fric

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

emusegs database
euclidean

Find the inter-euclidean distance for a data matrix
engassim.epg

EPG-compressed trackdata from the segment list engassim
engassim

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.
label

Get labels / utterances from segment list
get_trackdata

Get trackdata from loaded emuDB
isol.fdat

Trackdata of formants from the segment list isol
list_sessions

List sessions of emuDB
import_mediaFiles

Import media files to emuDB
isol.l

Vector of vowel phoneme labels from the segment list isol
dsmooth

Smooth the data in a trackdata object.
engassim.l

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

Emu segment List
emuRsegs

emuR segment list
emuR-package

emuR - Main Package of the EMU Speech Database Management System
load_emuDB

Load emuDB
dtime

time signal times
expand_labels

Label each data sample
label_convert

convert label
e.dft

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

Calculate ellipse coordinates
epgsum

Sum contacts in palatograms.
epgcog

Electropalatographic centre of gravity
dip

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

Electropalatographic contact indices
dur.emusegs

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

Plot palatographic data
dur.trackdata

Duration of trackdata elements
dip.fdat

Trackdata of formants from the segment list dip
epggs

Plot a grey-scale image of palatographic data.
eplot

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

Make an Emu segment list from the various components
linear.av

linear av
get.time.element

Get data for a given time
list_bundles

List bundles of emuDB
is.trackdata

Test whether an object is an Emu trackdata object
get.trackkeywrd

get trackkeywrd
isol

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

Classify using Mahalanobis distance
frames.time

Find the time and position of a data element.
frames

frames
engassim.w

Vector of word labels from the segment list engassim.
is.seglist

is seglist
fric.w

Vector of word labels from the segment list fric.
moments

Function to calculate statistical moments
makelab

Write out ESPS-style label files
mu.colour

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

Make emuDB segment list
mahal.dist

Calculate mahalanobis distances
polygonplot

polygonplot
mahalanobis.metric

mahalanobis metric
palate

Obtain a three-dimensional palatographic array
print.emuRsegs

Print emuRsegs segment list
is.spectral

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

Performance (hit rate) of a confusion matrix
fric.dft

Spectral trackdata object from the segment list fric.
nearey.sub

nearey sub
gerst.sub

gerst sub
fric.l

Vector of labels from the segment list fric
list_sampleRates

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

List files of emuDB
label_num

num label
mu.legend

make a EMU legend
lob.sub

lob sub
mu.colour.get

get a EMU color
locus

Calculate locus equations for two-dimensional data
linear

Perform linear time normalisation on trackdata.
mel.default

mel default
modify.seglist

Modify one of the components of an Emu segment list
read.emusegs

Create an Emu segment list from a file
norm

Normalise speech data
mu.linetype.get

mu linetype get
read_bundleList

read bundleList
matscan

Read matrix data from a file
plot.trackdata

Produces time-series plots from trackdata
runBASwebservice_maus

Runs MAUS webservice to create a phonetic segmentation
runBASwebservice_g2pForTokenization

Tokenizes an orthographic transcription.
plafit

Calculate the coefficients of a parabola
plot.spectral

Plot spectra from EMU spectral objects
muclass

Find common elements in vectors
rename_bundles

Rename bundles in emuDB
[.trackdata

Expand trackdata
polhom.epg

EPG-compressed trackdata from the segment list polhom
polhom.l

Vector of phonetic labels from the segment list polhom
print.trackdata

print trackdata
replace_itemLabels

Replace item labels
summary.emuDBhandle

Print summary of loaded EMU database (emuDB).
requery_hier

Requery hierarchical context of a segment list in an emuDB
print.emuRtrackdata

Print emuRtrackdata object
normalize_length

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

Convert Hz to the mel scale
outliers

outliers
rename_emuDB

Rename emuDB
runBASwebservice_chunker

Creates a chunk segmentation using the webservice Chunker.
runBASwebservice_g2pForPronunciation

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

Query emuDB
runBASwebservice_pho2sylSegmental

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

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

print emusegs
segmentlist

Segment list
resample_annots

Resample annotations (_annot.json) files of emuDB
requery_seq

Requery sequential context of segment list in an emuDB
splitstring

Split a string into words.
vowlax.dft.5

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

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

expand EPG
[.spectral

Expand spectral
randomise.segs

Randomise or Reverse items in a segment list
rbind.trackdata

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

summary trackdata
summary.emusegs

summary emusegs
vowlax.df

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

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

Segment list of four Polish homorganic fricatives from database epgpolish.
rescale.gerst

rescale gerst
vowlax.l

Vector of phoneme labels from the segment list vowlax
vowlax.fund

Trackdata of fundamental frequency from the segment list vowlax
vowlax

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

Track data object
write.emusegs

Write an Emu segment list to a file
wordlax.l

Vector of word labels from segment list wordlax
rad

Function to convert between Hertz and Radians
trackfreq

function to find the frequencies of a spectral object
sort.emuRsegs

Sort emuRsegs segment list by session, bundle and sample_start
rescale.lob

rescale lob
sortmatrix

Sort matrix by label
vowlax.fund.5

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

Get the track times from EMU trackdata objects
vowlax.fdat

Trackdata of formants from the segment list vowlax
train

Train a Gaussian Model
vowlax.rms.5

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

Start and end times for EMU segment lists and trackdata objects
update_itemsInLevel

Update items programmatically
vowlax.rms

Trackdata of RMS energy from the segment list vowlax
trapply

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

write bundleList
vowlax.left

Vector of labels preceding the vowels from the segment list vowlax
vowlax.right

Vector of labels following the vowels from the segment list vowlax
runBASwebservice_all

Runs several BAS webservices, starting from an orthographic transcription
rescale.nearey

rescale nearey
radians

Converts degrees to radians
shift

Function to shift the elements of a vector.
track.gradinfo

Calculate gradient summary information for trackdata
serve

Serve EMU database to EMU-webApp
track.gradinfo.sub

track gradinfo sub
vowlax.word

Vector of word labels from the segment list vowlax.
vowlax.spkr

Vector of speaker labels from the segment list vowlax.
AddListRemoveLevelDefinitions

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

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

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

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

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

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

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

Set / Get signalCanvasesOrder of / to / from emuDB
SetGetlevelCanvasesOrder

Set / Get level canvases order of emuDB
SetGetRemoveLegalLabels

Set / Get / Remove legal labels of attributeDefinition of emuDB