scripts/channelClasses/mock_eyet/Simple.java
/////////////////////////////////////////////////////////////////
// This script generates (somewhat) realistic EYET data.
//
// Run with (for example)
// java -cp build:lib/derby.jar -Dserver.cache.enable=false -Djava.library.path=c frontendClasses/CLI -scriptChannel mock_eyet/Simple -reviewSeries -paradigm eyet -binZ site -transform power -display "TiledStack()" "Export(to=window, as=txt)" -v
/////////////////////////////////////////////////////////////////
package mock_eyet;
import java.io.*;
import java.util.*;
import epochClasses.*;
import generalClasses.*;
import recordingClasses.Recording;
import seriesClasses.*;
import seriesClasses.seriesGeneration.Erlang;
import channelClasses.ChannelScript;
import static channelClasses.Channel.*;
/////////////////////////////////////////////////////////////////
/** This script generates (somewhat) realistic EYET data. The horizontal
* EOG contains the relevant signal.
*
* <p>The intended effect is:
* <ul><li>Demonstrate EOG with saccades</li>
* </ul>
*/
public class Simple extends ChannelScript
{
/** Recording instance to be operated on */
Recording rec = null;
/** Time series */
ArrayList<SeriesAnalog> list = new ArrayList<SeriesAnalog>();
/** Events. May be left empty */
ArrayList<Event> ev = new ArrayList<Event>();
////////////////////////////////////////////////////////////////////
/** Initialize instance by setting its parameters to default values.
*/
public Simple(Recording rec) {
this.rec = rec;
} // Simple
////////////////////////////////////////////////////////////////////
/** Update recording data by performing channel-oriented operations.
*/
public void update() {
// Template - used to encapsulate all sampling characteristics
float x0 = 0.0f; // in seconds: times start at x0
float xDelta = 0.004f; // in seconds: times increment by xDelta
float duration = 87.0f; // in seconds: times end at x0+duration
int nIndexes = Math.round(duration/xDelta);
SeriesAnalog template = new SeriesAnalog(new SiteSet(), // sites
x0, // x0
xDelta, // xDelta
new Units(Unit.s), // xUnits
nIndexes, // # samples
new Units(Unit.uV), // yUnits
DataMode.EEG); // DataMode
// Channels resulting from mixing sources: row labels of mixing matrix
String[] labels = {"Fz", "C3", "Cz", "C4", "Pz", "EOGh", "ECG"};
// Generate time series from source[] and factors[][]
for(int site=0; site<labels.length; site++) {
// What modality?
DataMode mode = DataMode.EEG;
if(labels[site].matches("[eE][oO][gG].*")) mode=DataMode.EOG;
else if(labels[site].matches("[eE][cCkK][gG].*"))mode=DataMode.ECG;
// New series
SeriesAnalog sum = null;
if(mode.equals(DataMode.EEG)) {
// Create noise only
float t0 = 0.09f;
sum = getEegWithAlpha(template, t0);
} else if(mode.equals(DataMode.EOG)) {
// Create sum of noise and ERPs
float t0 = 0.09f;
sum = getEegWithAlpha(template, t0);
sum.add(getEogSine(template));
sum.add(getEogSaccade(template));
} else if(mode.equals(DataMode.ECG)) {
sum = getEcg(template);
}
sum.setSites(new SiteSet(new Site(labels[site])));
sum.setMode(mode);
// Append sum to result
list.add(sum);
}
// Add synthetic time series to the currently empty Recording
replaceAllSeries(rec, list);
replaceAllEvents(rec, ev);
} // update
////////////////////////////////////////////////////////////////////
/** Dump summary of this class or object
* @return String representation of this object
*/
public String toString() {
String s = "<<<"+this.getClass().toString()+">>>\n";
return s;
} // toString
////////////////////////////////////////////////////////////////////
/** Generate pseudo EOG containing sine wave and saccades.
*/
SeriesAnalog getEogSine(SeriesAnalog template) {
float stimHz = 0.27f;
float twoPiF = (float)(2*Math.PI*stimHz);
// Create sine time series, with general character matching template
SeriesAnalog series = template.clone().setRamp(0.0f,twoPiF);
series.transformSin();
series.mul(50.0f);
return series;
} // getEogSine
////////////////////////////////////////////////////////////////////
/** Generate pseudo EOGh containing 'saccades' and low frequency noise
* If the saccade duration is blinkDur=0.1 s and impulses are scaled by
* blinkArea=10 uV.s, then we should see a clear 100 uV peak in EOG.
*/
SeriesAnalog getEogSaccade(SeriesAnalog template) {
float blinkDur = 0.1f; // width of blink, in sec
float blinkArea = 10.0f; // width*height of blink, in uV sec
float eogLP = 2.0f; // LP cutoff for EOG signals
float eogRms = 5.0f; // rms of ongoing EOG signals
float x0 =template.getFirstX(); // Initial time
float xDelta = template.getXDelta(); // sampling interval, in seconds
float white = eogRms/(float)Math.sqrt(eogLP*xDelta*2); // equiv noise
float duration = template.getXDelta()*template.getNIndexes();
// Saccade times.
float[] times = {
x0+0.1003f*duration, x0+0.3015f*duration,x0+0.7027f*duration,
x0+0.75f*duration, x0+0.77f*duration, x0+0.79f*duration,
x0+0.81f*duration, x0+0.83f*duration, x0+0.85f*duration,
x0+0.87f*duration, x0+0.89f*duration, x0+0.91f*duration,
x0+0.93f*duration, x0+0.95f*duration, x0+0.97f*duration};
return SeriesAnalog.getImpulseTimeseries(template,times)
.filterBox(blinkDur).mul(blinkArea)
.add(SeriesAnalog.getWhiteTimeseries(template,white).filterLP(eogLP));
} // getEogSaccade
////////////////////////////////////////////////////////////////////
/** Generate pseudo EEG containing alpha
*/
SeriesAnalog getEegWithAlpha(SeriesAnalog template, float t0) {
float lnorm = 2.5f;
return SeriesAnalog.getModelledEegTimeseries(template,t0,lnorm);
} // getEegWithAlpha
////////////////////////////////////////////////////////////////////
/** Generate pseudo ECG.
* The wavelet is a standard ERP, but deliberately truncated to
* make it more spike-like.
* The ECG will have R-R intervals of 0.80+var seconds, where 'var'
* has a gamma distribution, with mean equal to 0.1 seconds.
*/
private SeriesAnalog getEcg(SeriesAnalog template) {
float ecgDuration = 0.2f;
float xDelta = template.getXDelta(); // sampling interval, in seconds
int nIndexes = Math.round(ecgDuration/xDelta);
if((nIndexes&1)==0) nIndexes++;
float x0 = -(nIndexes-1)*xDelta/2; // so wavelet is centred on 0 secs
SeriesAnalog wavelet = new SeriesAnalog(new SiteSet(), // sites
x0, // x0
xDelta, // xDelta
new Units(Unit.s), // xUnits
nIndexes, // # samples
new Units(), // yUnits
DataMode.ECG); // DataMode
float lnorm = -5.0f;
SeriesAnalog erp =SeriesAnalog.getModelledErpTimeseries(wavelet,lnorm);
Erlang ran = new Erlang(0.1/5, 5, 0); // scale = mean/5
ArrayList<Float> timesList = new ArrayList<Float>();
float t = template.getFirstX()+0.3f; // time of first ECG event
float duration = template.getXDelta()*template.getNIndexes();
while(t<duration) {
timesList.add(new Float(t));
t += (float)(0.8+ran.gen());
}
float[] times = new float[timesList.size()];
for(int i=0; i<timesList.size(); i++) times[i] = timesList.get(i);
return SeriesAnalog.getImpulseTimeseries(template,times)
.mul(xDelta).convolveAsym(erp);
} // getEcg
}