syntheticemg: Synthetic EMG

In biosignalEMG: Tools for Electromyogram Signals (EMG) Analysis

Description

Creates a synthetic EMG based on a simple heteroscedastic model.

Usage

syntheticemg(n.length.out = 10000, on.sd = 1, on.duration.mean = 350,
   on.duration.sd = 10, off.sd = 0.05, off.duration.mean = 300,
   off.duration.sd = 20, on.mode.pos = 0.75, shape.factor = 0.5,
   samplingrate = 0, units = "", data.name = "Synthetic EMG")

Arguments

n.length.out	number of observations.
on.sd	Standard deviation of the random values during an active phase.
on.duration.mean	mean lengths of active phases in number of samples.
on.duration.sd	standard deviation of lengths of active phases in number of samples.
off.sd	standard deviation of the random values during an silence phase (i.e. for the baseline noise).
off.duration.mean	mean lengths of silence phases in number of samples.
off.duration.sd	standard deviation of lengths of silence phases in number of samples.
on.mode.pos	a value between 0 (beginning of the active phase) and 1 (end of the active phase) indicating the relative position in which the maximum amplitude of an active phase will be located.
shape.factor	shape parameter (recommended values between 0 and 2).
samplingrate	sampling rate associated to the synthetic EMG.
units	units associated to the synthetic EMG.
data.name	a string specifying the name of the variable which will appears on the plots.

Details

A random synthetic EMG signal is generated using an heteroscedastic Gaussian model. There are two parameters that control the amplitude of the active and silence phases (on.sd and off.sd), two that control the (random) length of the active phases (on.duration.mean and on.duration.sd), two that control the (random) length of the silence phases (off.duration.mean and off.duration.sd) and two that control the shape of the burst during an active phase (on.mode.pos and shape.factor). A binary vector stores which samples are associated to an active phase for test purposes.

Value

A derived ‘emg’ object which also contains a binary vector on.off to indicate which samples correspond to an active phase (1) and which to a silence phase (0).

Author(s)

J.A. Guerrero [e-mail]

References

Esquivel M.E., Guerrero J.A., Macias-Diaz J.E. (2010) Activity pattern detection in electroneurographic and electromyogram signals through a heteroscedastic change-point method. Mathematical Biosciences 224(2) 109–117

See Also

emg

Examples

# change graphical parameters to show multiple plots
op <- par(mfrow = c(2, 1))

# Simulate 10 seconds of an EMG
emg1 <- syntheticemg(n.length.out = 10000, on.sd = 1, on.duration.mean = 350, 
    on.duration.sd = 10, off.sd = 0.05, off.duration.mean = 300, off.duration.sd = 20, 
    on.mode.pos = 0.75, shape.factor = 0.5, samplingrate = 1000, units = "mV", 
    data.name = "Synthetic EMG")
plot(emg1, main = "Synthetic EMG")

# Simulate 10 seconds of an EMG (pulse trains)
emg2 <- syntheticemg(n.length.out = 10000, on.sd = 1, on.duration.mean = 350, 
    on.duration.sd = 10, off.sd = 0.05, off.duration.mean = 300, off.duration.sd = 20, 
    on.mode.pos = 0.5, shape.factor = 0, samplingrate = 1000, units = "mV", 
    data.name = "Synthetic EMG")
plot(emg2, main = "Synthetic EMG (pulse trains)")

# reset graphical parameters
par(op)

Example output

biosignalEMG documentation built on May 2, 2019, 12:07 p.m.