scripts/channelClasses/mock_faces/Simple.java
/////////////////////////////////////////////////////////////////
// This script generates (somewhat) realistic FACES data.
//
// Run with (for example)
// java -cp build:lib/derby.jar -Dserver.cache.enable=false -Djava.library.path=c frontendClasses/CLI -scriptChannel mock_faces/Simple -reviewSeries -paradigm faces -binH stim -binZ site -display "TiledStack()" -v
/////////////////////////////////////////////////////////////////
package mock_faces;
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 FACES data.
* The EEG contains unconscious and conscious events in blocks of 12, with
* or without a startle.
*
* <p>The intended effect is:
* <ol><li>Demonstrate event generation</li>
* </ol>
*/
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 = 719.6f; // 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
String[] labels = {"Fz", "C3", "Cz", "C4", "Pz", "ECG"};
// Standard ERP; update event list also
SeriesAnalog erp = getEegWithErps(template);
// Generate time series
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 sum of noise and ERPs
float t0 = 0.09f;
sum = getEegWithAlpha(template, t0);
sum.add(erp);
} 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 EEG containing ERPs. Also update the event list, ev.
* The event labels must match those in SeriesBinary.buildXXX_NS5Event().
* The ERP is about +15 uV in amplitude.
*/
private SeriesAnalog getEegWithErps(SeriesAnalog template) {
float erpDuration = 1.0f;
float xDelta = template.getXDelta(); // sampling interval, in seconds
int nIndexes = Math.round(erpDuration/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.EEG); // DataMode
float lnorm = -1.0f;
SeriesAnalog erp =SeriesAnalog.getModelledErpTimeseries(wavelet,lnorm);
// Generate multiple impulses, y[], with modulated areas, plus events
String[] block = { // [U|C] x [H|S|F|A|D|N] x 4 = 48 blocks
"UA", "UF", "US", "UD", "UH", "UN", // 0, 12, 24, 36, 48, 60
"UA", "UH", "UD", "UN", "UF", "US", // 72, 84, 96,108,120,132
"UF", "US", "UH", "UN", "UA", "UD", // 144,156,168,180,192,204
"UD", "UN", "UA", "UH", "UF", "US", // 216,228,240,252,264,276
"CA", "CD", "CF", "CH", "CN", "CS", // 288,300,312,324,336,348
"CS", "CD", "CA", "CF", "CN", "CH", // 360,372,384,396,408,420
"CH", "CD", "CA", "CN", "CF", "CS", // 432,444,456,468,480,492
"CF", "CN", "CD", "CA", "CS", "CH" // 504,516,528,540,552,564
};
boolean[] startle = {
true, true, false, false, false, true, // 0, 12, 24, 36, 48, 60
false, false, false, false, false, false,// 72, 84, 96,108,120,132
false, true, true, false, true, true, // 144,156,168,180,192,204
true, true, false, true, true, true, // 216,228,240,252,264,276
false, false, false, false, false, true, // 288,300,312,324,336,348
false, true, true, true, true, true, // 360,372,384,396,408,420
false, true, false, false, false, true, // 432,444,456,468,480,492
true, true, false, true, false, true // 504,516,528,540,552,564
};
assert (block.length == startle.length): "In mock_faces/Simple.java: "+
"block[] and startle[] have mismatching lengths";
int nEvents = 12*block.length;
float[] y = new float[template.getNIndexes()];
for(int i=0; i<nEvents; i++) {
String label = block[i/12] + ((startle[i/12] && i%12==8)? "!": "");
float scale = (startle[i/12] && i==8)? 2.0f: 1.0f;
double time = (i<nEvents/2)? 1.1+1.2*i: 373.45+1.2*(i-nEvents/2);
int offset = template.getIndex((float)time);
if(offset>=0 && offset<template.getNIndexes())
y[offset] = scale;
ev.add(new Event(time, 0, 0.200, label));
}
SeriesAnalog s = new SeriesAnalog(template,y);
return s.convolveAsym(erp);
} // getEegWithErps
////////////////////////////////////////////////////////////////////
/** Generate pseudo EEG containing alpha
*/
private 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
}