#include <repro.h>

Inheritance diagram for RePro:

Collaboration diagram for RePro:

Public Types
enum	DoneState { Completed, Aborted, Failed, Continue }

Public Types inherited from ConfigClass
enum	Action { Save =1, Dialog =2, Help =4, Menu =8 }

Public Types inherited from Options
enum	SaveFlags { NoName = 1, NoType = 2, NoInclude = 4, SwitchNameType = 8, Embrace = 16, PrintRequest = 32, FirstOnly = 64, PrintType = 128, PrintStyle = 256, DontCloseSection = 512, AlwaysQuote = 1024, EscapeQuotes = 2048 }

typedef deque< Parameter > ::iterator	iterator

typedef deque< Parameter > ::const_iterator	const_iterator

typedef deque< Options * > ::iterator	section_iterator

typedef deque< Options * > ::const_iterator	const_section_iterator

Public Member Functions
	RePro (const string &name, const string &pluginset="", const string &author="unknown", const string &version="unknown", const string &date=__DATE__)

virtual	~RePro (void)

virtual void	setName (const string &name)

virtual void	readConfig (StrQueue &sq)

virtual void	saveConfig (ofstream &str)

virtual int	main (void)=0

bool	interrupt (void) const

void	start (QThread::Priority priority=QThread::InheritPriority)

virtual void	requestStop (void)

bool	isRunning (void) const

bool	wait (double time=-1.0)

bool	sleep (double t, double tracetime=-1.0)

void	timeStamp (void)

bool	sleepOn (double t)

bool	sleepWait (double time=-1.0)

void	wake (void)

void	enable (void)

void	disable (void)

virtual void	sessionStarted (void)

virtual void	sessionStopped (bool saved)

bool	completed (void) const

bool	aborted (void) const

bool	failed (void) const

int	completeRuns (void) const

int	totalRuns (void) const

int	allRuns (void) const

int	failedRuns (void) const

double	reproTime (void) const

string	reproTimeStr (void) const

double	reproStartTime (void) const

int	testWrite (OutData &signal)

int	testWrite (OutList &signal)

int	write (OutData &signal, bool setsignaltime=true)

int	write (OutList &signal, bool setsignaltime=true)

int	startWrite (OutData &signal, bool setsignaltime=true)

int	startWrite (OutList &signal, bool setsignaltime=true)

int	directWrite (OutData &signal, bool setsignaltime=true)

int	directWrite (OutList &signal, bool setsignaltime=true)

int	writeZero (int channel, int device)

int	writeZero (int index)

int	writeZero (const string &trace)

int	stopWrite (void)

double	minLevel (int trace) const

double	minLevel (const string &trace) const

double	maxLevel (int trace) const

double	maxLevel (const string &trace) const

void	levels (int trace, vector< double > &l) const

void	levels (const string &trace, vector< double > &l) const

double	minIntensity (int trace, double frequency=0.0) const

double	minIntensity (const string &trace, double frequency=0.0) const

double	maxIntensity (int trace, double frequency=0.0) const

double	maxIntensity (const string &trace, double frequency=0.0) const

void	intensities (int trace, vector< double > &ints, double frequency=0.0) const

void	intensities (const string &trace, vector< double > &ints, double frequency=0.0) const

void	setMessage (bool message=true)

void	noMessage (void)

void	message (const string &msg)

string	addPath (const string &file) const

void	keepFocus (void)

void	grabKey (int key)

void	releaseKey (int key)

void	releaseKeys (void)

int	softStop (void)

void	setSoftStop (int s=1)

void	clearSoftStop (void)

void	setSoftStopKey (int keycode)

void	tracePlotOn (bool on=true)

void	tracePlotOff (void)

void	tracePlotSignal (double length, double offs=0.0)

void	tracePlotSignal (void)

void	tracePlotContinuous (double length)

void	tracePlotContinuous (void)

string	macroName (void)

string	macroParam (void)

string	reproPath (bool version=true)

string	addReProPath (const string &file, bool version=true)

virtual void	dialog (void)

Options &	overwriteOptions (void)

string	checkOptions (const string &opttxt)

virtual void	setSaving (bool saving)

void	noSaving (void)

virtual bool	eventFilter (QObject watched, QEvent e)

Public Member Functions inherited from RELACSPlugin
	RELACSPlugin (const string &configident="", int configgroup=0, const string &name="", const string &pluginset="", const string &author="unknown", const string &version="unknown", const string &date=__DATE__)

virtual	~RELACSPlugin (void)

QWidget *	widget (void)

void	setWidget (QWidget *widget)

void	setLayout (QLayout *layout)

int	desktopWidth (void) const

int	desktopHeight (void) const

string	pluginSet (void) const

string	uniqueName (void) const

void	setShortUniqueName (void)

void	setLongUniqueName (void)

void	updateUniqueName (void)

const Options &	settings (void) const

Options &	settings (void)

void	setSettings (void)

virtual void	modeChanged (void)

virtual void	notifyMetaData (void)

virtual void	notifyStimulusData (void)

void	setRELACSWidget (RELACSWidget *rw)

virtual string	helpFileName (void) const

const InList &	traces (void) const

const InData &	trace (int index) const

const InData &	trace (const string &ident) const

int	traceIndex (const string &ident) const

string	traceNames (void) const

string	rawTraceNames (void) const

const EventList &	events (void) const

const EventData &	events (int index) const

const EventData &	events (const string &ident) const

const EventData &	stimulusEvents (void) const

const EventData &	restartEvents (void) const

const EventData &	recordingEvents (void) const

int	traceInputTrace (int trace) const

int	traceInputTrace (const string &ident) const

int	traceInputEvent (int trace) const

int	traceInputEvent (const string &ident) const

int	eventInputTrace (int event) const

int	eventInputTrace (const string &ident) const

int	eventInputEvent (int event) const

int	eventInputEvent (const string &ident) const

double	signalTime (void) const

double	currentTime (void) const

double	currentTimeRaw (void) const

void	addTracesEvents (deque< InList * > &data, deque< EventList * > &events)

void	setTracesEvents (const InList &data, const EventList &event)

void	assignTracesEvents (const InList &data, const EventList &events)

void	assignTracesEvents (void)

void	updateDerivedTracesEvents (void)

int	getData (double mintracetime=0.0, double prevsignal=-1000.0)

int	outTracesSize (void) const

int	outTraceIndex (const string &name) const

string	outTraceName (int index) const

string	outTraceNames (void) const

const TraceSpec &	outTrace (int index) const

const TraceSpec &	outTrace (const string &name) const

void	setSignalDelay (int device, double delay)

bool	acquisition (void) const

bool	simulation (void) const

bool	analysis (void) const

bool	idle (void) const

string	modeStr (void) const

Options &	relacsSettings (void)

const Options &	relacsSettings (void) const

void	lockRelacsSettings (void) const

void	unlockRelacsSettings (void) const

QMutex *	relacsSettingsMutex (void)

string	path (void) const

string	addPath (const string &file) const

string	defaultPath (void) const

string	addDefaultPath (const string &file) const

bool	saving (void) const

Options &	stimulusData (void)

const Options &	stimulusData (void) const

int	stimulusDataTraceFlag (void) const

void	lockStimulusData (void) const

void	unlockStimulusData (void) const

QMutex *	stimulusDataMutex (void)

MetaData &	metaData (void)

const MetaData &	metaData (void) const

void	lockMetaData (void) const

void	unlockMetaData (void) const

QMutex *	metaDataMutex (void)

AllDevices *	devices (void) const

Device *	device (const string &ident)

void	updateDeviceMenu (void)

DigitalIO *	digitalIO (const string &ident)

Trigger *	trigger (const string &ident)

Attenuate *	attenuator (const string &name)

Filter *	filter (const string &name)

Filter *	filterTrace (int index)

Filter *	filterTrace (const string &name)

Options &	filterOpts (const string &name)

Options &	filterTraceOpts (int index)

Options &	filterTraceOpts (const string &name)

void	lockFilter (const string &name)

void	lockFilterTrace (int index)

void	lockFilterTrace (const string &name)

void	unlockFilter (const string &name)

void	unlockFilterTrace (int index)

void	unlockFilterTrace (const string &name)

void	autoConfigureFilter (Filter *filter, double tbegin, double tend)

void	autoConfigureFilter (Filter *filter, double duration)

void	autoConfigureFilter (double tbegin, double tend)

void	autoConfigureFilter (double duration)

Filter *	detector (const string &name)

Filter *	detectorEvents (int index)

Filter *	detectorEvents (const string &name)

Options &	detectorOpts (const string &name)

Options &	detectorEventsOpts (int index)

Options &	detectorEventsOpts (const string &name)

void	lockDetector (const string &name)

void	lockDetectorEvents (int index)

void	lockDetectorEvents (const string &name)

void	unlockDetector (const string &name)

void	unlockDetectorEvents (int index)

void	unlockDetectorEvents (const string &name)

void	autoConfigureDetector (Filter *detector, double tbegin, double tend)

void	autoConfigureDetector (Filter *detector, double duration)

void	autoConfigureDetectors (double tbegin, double tend)

void	autoConfigureDetectors (double duration)

double	sessionTime (void) const

string	sessionTimeStr (void) const

bool	sessionRunning (void) const

int	reproCount (void) const

bool	globalKeyEvents (void)

void	setGlobalKeyEvents (bool global=true)

Public Member Functions inherited from ConfigDialog
	ConfigDialog (const string &configident="", int configgroup=0, const string &name="", const string &author="", const string &version="", const string &date=__DATE__)

virtual	~ConfigDialog (void)

string	name (void) const

string	author (void) const

virtual void	setAuthor (const string &author)

string	version (void) const

virtual void	setVersion (const string &version)

string	date (void) const

virtual void	setDate (const string &date)

virtual OptWidget *	dialogOptions (OptDialog od, string tabhotkeys=0)

virtual void	dialogButtons (OptDialog *od)

virtual void	dialogEmptyMessage (OptDialog *od)

int	dialogSelectMask (void) const

void	setDialogSelectMask (int mask)

void	addDialogSelectMask (int mask)

int	dialogReadOnlyMask (void) const

void	setDialogReadOnlyMask (int mask)

void	addDialogReadOnlyMask (int mask)

int	dialogStyle (void) const

void	setDialogStyle (int style)

void	addDialogStyle (int style)

string	dialogCaption (void) const

void	setDialogCaption (const string &caption)

bool	dialogHeader (void) const

void	setDialogHeader (bool d)

string	headerBackgroundColor (void) const

void	setHeaderBackgroundColor (const string &color)

string	headerForegroundColor (void) const

void	setHeaderForegroundColor (const string &color)

string	headerImageFile (void) const

void	setHeaderImageFile (const string &file)

virtual void	dialogHeaderWidget (OptDialog *od)

bool	dialogHelp (void) const

void	setDialogHelp (bool d)

string	helpCaption (void) const

void	setHelpCaption (const string &caption)

string	helpPath (int inx=0) const

int	helpPathes (void) const

void	clearHelpPathes (void)

void	setHelpPath (const string &path)

void	addHelpPath (const string &path)

bool	dialogOpen (void) const

bool	helpOpen (void) const

QWidget *	mainWidget (void)

virtual void	setMainWidget (QWidget *widget)

void	lock () const

void	unlock () const

bool	tryLock (int timeout=1)

QMutex *	mutex (void)

Public Member Functions inherited from ConfigClass
	ConfigClass (const string &ident, int group=0, int mode=0xffff, int selectmask=0)

	ConfigClass (const ConfigClass &C)

virtual	~ConfigClass (void)

const string &	configIdent (void) const

void	setConfigIdent (const string &ident)

int	configGroup (void) const

void	setConfigGroup (int group)

int	configMode (void) const

void	setConfigMode (int mode)

void	addConfigMode (int mode)

void	delConfigMode (int mode)

int	configSelectMask (void) const

void	setConfigSelectMask (int mask)

void	addConfig (void)

void	readConfig (void)

virtual int	configSize (void) const

virtual void	config (void)

virtual void	preConfig (void)

Public Member Functions inherited from Options
	Options (void)

	Options (const Options &o)

	Options (const Options &o, int flags)

	Options (const string &name, const string &type, int flags, int style)

	Options (const Str &opttxt, const string &assignment=":=", const string &separator=",;")

	Options (const StrQueue &sq, const string &assignment=":=")

	Options (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", string *line=0)

virtual	~Options (void)

Options &	operator= (const Options &o)

Options &	assign (const Options &o)

Options &	append (const Options &o)

Options &	add (const Options &o)

Options &	insert (const Options &o, const string &atname="")

Options &	assign (const Options &o, int flags)

Options &	copy (Options &o, int flags)

Options &	append (const Options &o, int flags)

Options &	add (const Options &o, int flags)

Options &	insert (const Options &o, int flags, const string &atname="")

Parameter *	assign (const string &name, const string &value)

Options *	parentSection (void)

const Options *	parentSection (void) const

void	setParentSection (Options *parentsection)

void	resetParents (void)

Options *	rootSection (void)

const Options *	rootSection (void) const

string	name (void) const

virtual void	setName (const string &name, const string &type)

string	type (void) const

void	setType (const string &type)

string	include (void) const

void	setInclude (const string &include)

void	setInclude (const string &url, const string &name)

int	flag (void) const

bool	flag (int selectflag) const

Options &	setFlag (int flag)

Options &	addFlag (int flag)

Options &	delFlag (int flag)

Options &	clearFlag (void)

int	style (void) const

Options &	setStyle (int style)

Options &	addStyle (int style)

Options &	delStyle (int style)

Options &	clearStyle (void)

bool	checkType (int mask) const

Str	warning (void) const

iterator	begin (void)

iterator	end (void)

const_iterator	begin (void) const

const_iterator	end (void) const

section_iterator	sectionsBegin (void)

section_iterator	sectionsEnd (void)

const_section_iterator	sectionsBegin (void) const

const_section_iterator	sectionsEnd (void) const

const_iterator	find (const string &pattern, int level=-1) const

iterator	find (const string &pattern, int level=-1)

const_iterator	rfind (const string &pattern, int level=-1) const

iterator	rfind (const string &pattern, int level=-1)

const_section_iterator	findSection (const string &pattern, int level=-1) const

section_iterator	findSection (const string &pattern, int level=-1)

const_section_iterator	rfindSection (const string &pattern, int level=-1) const

section_iterator	rfindSection (const string &pattern, int level=-1)

const Parameter &	operator[] (int i) const

Parameter &	operator[] (int i)

const Parameter &	operator[] (const string &name) const

Parameter &	operator[] (const string &name)

const Options &	section (int i) const

Options &	section (int i)

const Options &	section (const string &name) const

Options &	section (const string &name)

Str	request (const string &name) const

Parameter &	setRequest (const string &name, const string &request)

Parameter::ValueType	valueType (const string &name) const

Parameter &	setValueType (const string &name, Parameter::ValueType type)

int	flags (const string &name) const

bool	flags (const string &name, int flag) const

Parameter &	setFlags (const string &name, int flags)

Parameter &	addFlags (const string &name, int flags)

Parameter &	delFlags (const string &name, int flags)

Parameter &	clearFlags (const string &name)

bool	changed (const string &name)

int	style (const string &name) const

Parameter &	setStyle (const string &name, int style)

Parameter &	addStyle (const string &name, int style)

Parameter &	delStyle (const string &name, int style)

Str	format (const string &name) const

Parameter &	setFormat (const string &name, int width=0, int prec=-1, char fmt='g')

Parameter &	setFormat (const string &name, const string &format)

int	formatWidth (const string &name) const

int	size (const string &name) const

Parameter &	add (const Parameter &np)

Parameter &	insert (const Parameter &np, const string &atname="")

Parameter &	addText (const string &name, const string &request, const string &dflt, int flags=0, int style=0)

Parameter &	addText (const string &name, const string &dflt="", int flags=0, int style=0)

Parameter &	insertText (const string &name, const string &atname, const string &request, const string &dflt, int flags=0, int style=0)

Parameter &	insertText (const string &name, const string &atname="", const string &dflt="", int flags=0, int style=0)

Str	text (const string &name, int index, const string &dflt="", const string &format="", const string &unit="") const

Str	text (const string &name, const string &dflt="", const string &format="", const string &unit="") const

void	texts (const string &name, vector< string > &s, const string &format="", const string &unit="") const

Str	allText (const string &name, const string &dflt="", const string &format="", const string &unit="", const string &separator=", ") const

Parameter &	setText (const string &name, const string &strg)

Parameter &	setText (const string &name, const Parameter &p)

Parameter &	pushText (const string &name, const string &strg)

Str	defaultText (const string &name, const string &format="", const string &unit="") const

Parameter &	setDefaultText (const string &name, const string &dflt)

Parameter &	addSelection (const string &name, const string &request, const string &selection, int flags=0, int style=0)

Parameter &	addSelection (const string &name, const string &selection="", int flags=0, int style=0)

Parameter &	insertSelection (const string &name, const string &atname, const string &request, const string &selection, int flags=0, int style=0)

Parameter &	insertSelection (const string &name, const string &atname="", const string &selection="", int flags=0, int style=0)

Parameter &	selectText (const string &name, const string &strg, int add=0)

Parameter &	selectText (const string &name, int index)

int	index (const string &name) const

int	index (const string &name, const string &strg) const

Parameter &	addNumber (const string &name, const string &request, double dflt, double minimum, double maximum=MAXDOUBLE, double step=1.0, const string &unit="", const string &outputunit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, const string &request, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, double dflt, const string &unit, int flags, int style=0)

Parameter &	addNumber (const string &name, double dflt, double error, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &request, double dflt, double minimum, double maximum=MAXDOUBLE, double step=1.0, const string &unit="", const string &outputunit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &request, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &unit="", const string &format="", int flags=0, int style=0)

double	number (const string &name, double dflt=0.0, const string &unit="", int index=0) const

double	number (const string &name, const string &unit, double dflt=0.0, int index=0) const

double	number (const string &name, int index, double dflt=0.0, const string &unit="") const

double	number (const string &name, int index, const string &unit, double dflt=0.0) const

void	numbers (const string &name, vector< double > &n, const string &unit="") const

double	error (const string &name, const string &unit="", int index=0) const

double	error (const string &name, int index, const string &unit="") const

void	errors (const string &name, vector< double > &n, const string &unit="") const

Parameter &	setNumber (const string &name, double number, double error, const string &unit="")

Parameter &	setNumber (const string &name, double number, const string &unit="")

Parameter &	pushNumber (const string &name, double number, double error=-1.0, const string &unit="")

Parameter &	pushNumber (const string &name, double number, const string &unit)

Parameter &	setNumber (const string &name, const Parameter &p)

double	defaultNumber (const string &name, const string &unit="") const

Parameter &	setDefaultNumber (const string &name, double dflt, const string &unit="")

double	minimum (const string &name, const string &unit="") const

double	maximum (const string &name, const string &unit="") const

double	step (const string &name, const string &unit="") const

Parameter &	setStep (const string &name, double step, const string &unit="")

Parameter &	setMinMax (const string &name, double minimum=-MAXDOUBLE, double maximum=MAXDOUBLE, double step=1.0, const string &unit="")

Str	unit (const string &name) const

Str	outUnit (const string &name) const

Parameter &	setUnit (const string &name, const string &internunit, const string &outunit="")

Parameter &	setOutUnit (const string &name, const string &outputunit)

Parameter &	changeUnit (const string &name, const string &internunit)

Parameter &	addInteger (const string &name, const string &request, long dflt, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="", const string &outputunit="", int width=0, int flags=0, int style=0)

Parameter &	addInteger (const string &name, long dflt, const string &unit="", int width=0, int flags=0, int style=0)

Parameter &	addInteger (const string &name, const string &unit="")

Parameter &	insertInteger (const string &name, const string &atname, const string &request, long dflt, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="", const string &outputunit="", int width=0, int flags=0, int style=0)

Parameter &	insertInteger (const string &name, const string &atname, long dflt, const string &unit="", int width=0, int flags=0, int style=0)

Parameter &	insertInteger (const string &name, const string &atname, const string &unit="", int width=0, int flags=0, int style=0)

long	integer (const string &name, const string &unit="", long dflt=0, int index=0) const

long	integer (const string &name, int index, long dflt=0, const string &unit="") const

long	integer (const string &name, int index, const string &unit, long dflt=0) const

void	integers (const string &name, vector< long > &n, const string &unit="") const

void	integers (const string &name, vector< int > &n, const string &unit="") const

Parameter &	setInteger (const string &name, long number, long error, const string &unit="")

Parameter &	setInteger (const string &name, long number, const string &unit="")

Parameter &	pushInteger (const string &name, long number, long error, const string &unit="")

Parameter &	pushInteger (const string &name, long number, const string &unit="")

Parameter &	setInteger (const string &name, const Parameter &p)

long	defaultInteger (const string &name, const string &unit="") const

Parameter &	setDefaultInteger (const string &name, long dflt, const string &unit="")

Parameter &	setMinMax (const string &name, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="")

Parameter &	setMinMax (const string &name, int minimum, int maximum, int step=1, const string &unit="")

Parameter &	addBoolean (const string &name, const string &request, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const char name, const char request, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const string &name, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const char *name, bool dflt, int flags=0, int style=0)

Parameter &	insertBoolean (const string &name, const string &atname="", const string &request="", bool dflt=false, int flags=0, int style=0)

Parameter &	insertBoolean (const string &name, const string &atname, int flags=0, int style=0)

bool	boolean (const string &name, bool dflt=false, int index=0) const

bool	boolean (const string &name, int index, bool dflt=false) const

void	booleans (const string &name, vector< bool > &n) const

Parameter &	setBoolean (const string &name, bool b)

Parameter &	setBoolean (const string &name, const Parameter &p)

bool	defaultBoolean (const string &name) const

Parameter &	setDefaultBoolean (const string &name, bool dflt)

Parameter &	addDate (const string &name, const string &request, int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	addDate (const string &name, int year, int month, int day, int flags=0, int style=0)

Parameter &	addDate (const string &name, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname="", const string &request="", int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname, int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname, int flags=0, int style=0)

const Parameter &	date (const string &name, int index, int &year, int &month, int &day) const

Parameter &	setDate (const string &name, int year, int month, int day)

Parameter &	setDate (const string &name, const string &date)

Parameter &	setDate (const string &name, const struct tm &date)

Parameter &	setDate (const string &name, const time_t &time)

Parameter &	setCurrentDate (const string &name)

Parameter &	setDate (const string &name, const Parameter &p)

const Parameter &	defaultDate (const string &name, int index, int &year, int &month, int &day) const

Parameter &	setDefaultDate (const string &name, int year, int month, int day)

Parameter &	addTime (const string &name, const string &request, int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	addTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0, int flags=0, int style=0)

Parameter &	addTime (const string &name, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname="", const string &request="", int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname, int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname, int flags=0, int style=0)

const Parameter &	time (const string &name, int index, int &hour, int &minutes, int &seconds, int &milliseconds) const

Parameter &	setTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0)

Parameter &	setTime (const string &name, const string &time)

Parameter &	setTime (const string &name, const struct tm &time)

Parameter &	setTime (const string &name, const time_t &time)

Parameter &	setCurrentTime (const string &name)

Parameter &	setTime (const string &name, const Parameter &p)

const Parameter &	defaultTime (const string &name, int index, int &hour, int &minutes, int &seconds, int &milliseconds) const

Parameter &	setDefaultTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0)

Options &	newSection (int level, const string &name, const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const string &name, int flag, int style=0)

Options &	newSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSection (const string &name, int flag, int style=0)

Options &	newSubSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSubSection (const string &name, int flag, int style=0)

Options &	newSubSubSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const string &name, int flag, int style=0)

Options &	addSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	addSection (const string &name, int flag, int style=0)

Options &	insertSection (const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const string &name, const string &atpattern, int flag, int style=0)

Options &	newSection (int level, const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const Options &opt, const string &name, int flag, int style=0)

Options &	newSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (const Options &opt, const string &name, int flag, int style=0)

Options &	newSubSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSection (const Options &opt, const string &name, int flag, int style=0)

Options &	newSubSubSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const Options &opt, const string &name, int flag, int style=0)

Options &	addSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	addSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	addSection (const Options &opt, const string &name, int flag, int style=0)

Options &	insertSection (const Options &opt, int selectmask, const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const Options &opt, const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const Options &opt, const string &name, const string &atpattern, int flag, int style=0)

Options &	newSection (Options *opt, bool newparent=false)

Options &	addSection (Options *opt, bool newparent=false)

Options &	insertSection (Options *opt, const string &atpattern, bool newparent=false)

Options &	newSections (Options *opt, bool newparent=false)

void	endSection (void)

void	clearSections (void)

void	setSection (Options &opt)

void	lastSection (void)

int	up (void)

int	down (void)

Parameter &	setDefault (const string &name)

Options &	setDefaults (int flags=0)

Parameter &	setToDefault (const string &name)

Options &	setToDefaults (int flags=0)

Options &	erase (iterator p)

Options &	erase (section_iterator p)

Options &	erase (Options *s)

Options &	erase (const string &pattern)

Options &	erase (int selectflag)

Options &	pop (void)

Options &	popSection (void)

Options &	flatten (Options *root=0)

Options &	clear (bool revert=true)

int	size (void) const

int	size (int selectflag) const

bool	empty (void) const

int	parameterSize (void) const

int	parameterSize (int flags) const

int	sectionsSize (void) const

int	sectionsSize (int flags) const

bool	exist (const string &pattern) const

bool	existSection (const string &pattern) const

Options &	setFlags (int flags, int selectflag=0)

Options &	addFlags (int flags, int selectflag=0)

Options &	delFlags (int flags, int selectflag=0)

Options &	setValueTypeFlags (int flags, int typemask)

Options &	addValueTypeFlags (int flags, int typemask)

Options &	delValueTypeFlags (int flags, int typemask)

Options &	setStyles (int style, int selectflag=0)

Options &	addStyles (int style, int selectflag=0)

Options &	delStyles (int style, int selectflag=0)

int	styleSize (int style) const

Options &	setValueTypeStyles (int style, int typemask)

Options &	addValueTypeStyles (int style, int typemask)

Options &	delValueTypeStyles (int style, int typemask)

int	nameWidth (int selectmask=0, bool detailed=false, bool escape=false) const

string	save (int selectmask=0, int flags=0) const

ostream &	save (ostream &str, const string &start="", int selectmask=0, int flags=0, int width=-1) const

ostream &	save (ostream &str, const string &textformat, const string &numberformat, const string &boolformat="%i=%b", const string &dateformat="%i=%04Y-%02m-%02d", const string &timeformat="%i=%02H:%02M:%02S", const string &sectionformat="%i", int selectmask=0, const string &start="") const

ostream &	saveXML (ostream &str, int selectmask=0, int flags=0, int level=0, int indent=4) const

Options &	read (const string &opttxt, int flag, const string &assignment=":=", const string &separator=",;", int *indent=0)

Options &	read (const string &opttxt, const string &assignment=":=", const string &separator=",;")

istream &	read (istream &str, int flag, const string &assignment=":=", const string &comment="#", const string &stop="", Str *line=0)

istream &	read (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", Str *line=0)

Options &	read (const StrQueue &sq, int flag=0, const string &assignment=":=")

bool	read (const Parameter &p, int flag=0)

Options &	read (const Options &o, int flags=0, int flag=0)

bool	readAppend (const Parameter &p)

Options &	readAppend (const Options &o, int flags=0)

Options &	load (const Str &opttxt, const string &assignment=":=", const string &separator=",;", int indent=0, int indentspacing=0, int *level=0)

istream &	load (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", string *line=0)

Options &	load (const StrQueue &sq, const string &assignment=":=")

virtual void	notify (void)

void	callNotifies (void)

bool	setNotify (bool notify=true)

bool	unsetNotify (void)

bool	notifying (void) const

Static Public Attributes
static const int	MacroFlag = Parameter::ChangedFlag >> 1

static const int	OverwriteFlag = Parameter::ChangedFlag >> 2

static const int	CurrentFlag = Parameter::ChangedFlag >> 3

Static Public Attributes inherited from RELACSPlugin
static const int	DeviceId = 0x0001

static const int	AnalogInputId = 0x0002

static const int	AnalogOutputId = 0x0004

static const int	DigitalIOId = 0x0008

static const int	TriggerId = 0x0010

static const int	AttenuatorId = 0x0020

static const int	AttenuateId = 0x0040

static const int	ModelId = 0x0080

static const int	FilterId = 0x0100

static const int	ReProId = 0x0200

static const int	ControlId = 0x0400

static const int	Core = 0

static const int	Plugins = 1

Static Public Attributes inherited from Options
static const int	NonDefault = Parameter::NonDefault

static const long	TabSection = 0x04000000

Protected Slots
virtual void	customEvent (QEvent *qce)

Protected Slots inherited from RELACSPlugin
void	startTheSession (void)

void	stopTheSession (void)

void	toggleSession (void)

void	removeFocus (void)

void	muteAudioMonitor (void)

void	unmuteAudioMonitor (void)

virtual void	customEvent (QEvent *qce)

void	widgetDestroyed (QObject *obj)

Protected Slots inherited from ConfigDialog
void	notificationFromDialog (const Parameter &p)

virtual void	dClosed (int r)

virtual void	hClosed (int r)

Protected Member Functions
virtual void	keyPressEvent (QKeyEvent *event)

virtual void	keyReleaseEvent (QKeyEvent *event)

Protected Member Functions inherited from RELACSPlugin
virtual void	setPluginSet (const string &pluginset)

void	printlog (const string &s) const

void	warning (const string &s, double timeout=0.0)

void	info (const string &s, double timeout=0.0)

void	postCustomEvent (int type=0)

int	maxVoltages (const InData &data, vector< double > &ranges) const

int	maxValues (const InData &data, vector< double > &ranges) const

void	setGain (const InData &data, int gainindex)

void	adjustGain (const InData &data, double maxvalue)

void	adjustGain (const InData &data, double minvalue, double maxvalue)

void	adjust (const InData &data, double tbegin, double tend, double threshold)

void	adjust (const InData &data, double duration, double threshold)

int	activateGains (void)

Control *	control (int index)

Control *	control (const string &name)

Options &	controlOpts (int index)

Options &	controlOpts (const string &name)

void	lockControl (int index)

void	lockControl (const string &name)

void	unlockControl (int index)

void	unlockControl (const string &name)

Model *	model (void)

Options &	modelOpts (void)

void	lockModel (void)

void	unlockModel (void)

RePros *	repros (void)

Options &	reprosDialogOpts (void)

RePro *	repro (int index)

RePro *	repro (const string &name)

Options &	reproOpts (int index)

Options &	reproOpts (const string &name)

void	lockRePro (int index)

void	lockRePro (const string &name)

void	unlockRePro (int index)

void	unlockRePro (const string &name)

RePro *	currentRePro (void)

Options &	currentReProOpts (void)

void	lockCurrentRePro (void)

void	unlockCurrentRePro (void)

void	setWaitMouseCursor (void)

void	restoreMouseCursor (void)

Protected Member Functions inherited from ConfigDialog
void	setDialogOpen (bool open=true)

void	setHelpOpen (bool open=true)

Friends
class	ReProThread

Additional Inherited Members
Public Slots inherited from RELACSPlugin
virtual void	saveDoxygenOptions (void)

virtual void	saveWidget (void)

Public Slots inherited from ConfigDialog
virtual void	help (void)

virtual void	notifyDialog (const Options &opt)

Signals inherited from ConfigDialog
void	dialogAccepted (void)

void	dialogAction (int r)

void	dialogClosed (int r)

Static Public Member Functions inherited from ConfigClass
static void	setConfigureClasses (ConfigureClasses *cfg)

Static Public Member Functions inherited from Options
static double	floorLog10 (double v)

static double	floor10 (double v, double scale=1.0)

static double	ceil10 (double v, double scale=1.0)

Protected Attributes inherited from RELACSPlugin
RELACSWidget *	RW

Protected Attributes inherited from ConfigDialog
Options	DialogOptions

Detailed Description

Parent class of all research programs.

Author: Jan Benda; Christian Machens

Todo:

~RePro: auto remove from RePros?

addPath: something with a format string giving the RePro's name, totalRuns, etc.

Member Enumeration Documentation

enum DoneState

Different return values for the main() function.

Enumerator
Completed	The RePro completed its job and terminated normally.
Aborted	The RePro terminated before completing its job (usually due to a request by the user).
Failed	The RePro was not able to do its job properly.
Continue	Keep executing the RePro. Don't use this as a return value for main().

Constructor & Destructor Documentation

RePro	(	const string &	name,
		const string &	pluginset = `""`,
		const string &	author = `"unknown"`,
		const string &	version = `"unknown"`,
		const string &	date = `__DATE__`
	)

Constructs a RePro with name name (has to be identical to the class name) that belongs to the set of plugins named pluginset. The implementation of a class derived from RePro has the version version and was written by author on date. The date defaults to the date of compilation.

References ConfigDialog::addDialogStyle(), RePro::Continue, OptWidget::HideStyle, RePro::ReProThread, and OptWidget::TabSectionStyle.

~RePro ( void )

virtual

Destructs a RePro.

Member Function Documentation

void setName ( const string & name )

virtual

Set the name of the RePro to name.

Reimplemented from RELACSPlugin.

References ConfigClass::setConfigIdent(), and RELACSPlugin::setName().

void readConfig ( StrQueue & sq )

virtual

Read the RePro's default settings from the config file.

Reimplemented from ConfigClass.

References ConfigClass::readConfig(), and Options::setToDefaults().

void saveConfig ( ofstream & str )

virtual

Saves the RePro's default settings to the config file.

Reimplemented from ConfigClass.

References ConfigClass::saveConfig(), and Options::setDefaults().

virtual int main ( void )

pure virtual

This function is called when the RePro is started. You need to implement this function with some useful code, e.g. read options, create and play stimulus, analyze the read voltage traces and events, etc. This function is executed as a thread. Within this thread the RePro is locked (via lock()). Access to those data is unlocked during sleep(), sleepOn(), and sleepWait(). Beware that main() is executed in a thread different from the GUI thread. Use postCustomEvent() to call some functions that eventually paint something on the screen. The function should return one of the DoneStates except Continue. After main() terminated a message is written ( "Repro succesfully completed", "RePro stopped" or "RePro interupted", depending on the return value) and RELACS is informed. You need to return from main() if the sleep(), sleepOn(), or interrupt() functions return true. Also, if you lock() and unlock() the RePro manually, you should check interrupt() directly after each unlock(). If interrupt() returns true, you should be careful with posting custom events via postCustomEvent, since they might be executed after the RePro terminated. This includes calling message() and Plot::draw() or MultiPlot::draw(). The RePro's widget is enabled during execution of main().

See Also: interrupt(), sleep(), timeStamp(), sleepOn(), sleepWait(), enable()

Implemented in DefaultRePro.

bool interrupt ( void ) const

Returns true if the RePro thread should be stopped immediately. Use this from within main()

      int main( void )
{
...
if ( interrupt() )
  return Aborted;
...
}

Referenced by RePro::sleep().

void start ( QThread::Priority priority = QThread::InheritPriority )

Start execution of the RePro thread. Reimplement main() to make the thread do something.

Referenced by RELACSWidget::startRePro().

void requestStop ( void )

virtual

Kindly ask the RePro to stop. Sets interrupt() to true and terminates all sleeps. You still need to wait on the RePro thread to finish.

References RePro::stopWrite().

Referenced by RELACSWidget::stopRePro().

bool isRunning ( void ) const

Returns true if the RePro therad is running.

Referenced by RELACSWidget::stopRePro().

bool wait ( double time = -1.0 )

Wait on the RePro's thread to terminate or at most time seconds, if time is greater than zero.

References relacs::floor().

Referenced by RELACSWidget::stopRePro().

bool sleep	(	double	t,
		double	tracetime = `-1.0`
	)

Sleep for some time. Right before returning, the data and event buffers are updated.

Parameters

[in]	t	the time to sleep in seconds.
[in]	tracetime	the size the input data should have after the sleep. For internal use only!

Returns: true if the main() thread needs to be stopped.

See Also: sleepOn(), timeStamp(), sleepWait(), interrupt()

References RELACSPlugin::currentTime(), RELACSPlugin::getData(), RePro::interrupt(), ConfigDialog::mutex(), RELACSPlugin::RW, and RELACSWidget::updateRePro().

Referenced by DefaultRePro::main(), and RePro::sleepOn().

void timeStamp ( void )

Memorize the current time. This time is used by sleepOn() to calculate the remaining time to sleep.

See Also: sleepOn(), sleep(), sleepWait()

References RELACSPlugin::currentTime().

bool sleepOn ( double t )

Sleep for t seconds relative to the last call of timeStamp(). Right before returning, the data and event buffers are updated.

Parameters

[in] t the time to sleep since the last call to timeStamp() in seconds.

Returns: true if the main() thread needs to be stopped.

See Also: sleep(), sleepWait(), timeStamp(), interrupt()

References RePro::sleep().

bool sleepWait ( double time = -1.0 )

Wait on the RePro's waitcondition for sleeping or sleep for the specified time. The data and event buffers are NOT updated after sleeping.

Parameters

[in] time the maximum time to be waiting for, i.e. the time to sleep in seconds. If time is smaller than zero, sleepWait() waits forever.

Returns: false if sleepWait() slept for the specified time, true if sleeping was interrupted by wake().

See Also: wake()

References RELACSPlugin::getData(), and ConfigDialog::mutex().

void wake ( void )

Wake all threads that wait on the RePro's waitcondition for sleeping. In particular, interrupt a sleep(), sleepOn(), or sleepWait().

See Also: sleepWait()

void enable ( void )

Enable the RePro's widget, i.e. allow inputs to its GUI elements.

See Also: disable()

References RELACSPlugin::postCustomEvent().

void disable ( void )

Disable the RePro's widget, i.e. do not allow inputs to its GUI elements.

See Also: enable()

References RELACSPlugin::postCustomEvent().

Referenced by ReProData::reload(), and RePros::RePros().

void sessionStarted ( void )

virtual

Reimplement this function to reset or initialize your RePro when a new session is started. The current implementation resets the counters completeRuns(), totalRuns(), allRuns(), failedRuns(). So you should call from your implementation RePro::sessionStarted().

Reimplemented from RELACSPlugin.

Referenced by RePros::sessionStarted().

void sessionStopped ( bool saved )

virtual

Reimplement this function to reset your RePro after a session is stopped. If the session was saved saved is set to true. The current implementation resets the counters completeRuns(), totalRuns(), allRuns(), failedRuns(). So you should call from your implementation RePro::sessionStopped( saved ).

Reimplemented from RELACSPlugin.

Referenced by RePros::sessionStopped().

bool completed ( void ) const

In main(): true if previous call of this RePro was completed, i.e. main() returned Completed.

See Also: aborted(), failed(), completeRuns()

References RePro::Completed.

bool aborted ( void ) const

In main(): true if previous call of this RePro was aborted by the user, i.e. main() returned Aborted.

See Also: completed(), failed(), totalRuns()

References RePro::Aborted.

bool failed ( void ) const

In main(): true if previous call of this RePro failed, i.e. main() returned Failed.

See Also: completed(), aborted(), failedRuns()

References RePro::Failed.

int completeRuns ( void ) const

Number of completed runs of this RePro (main() returned Completed) since last call of sessionStarted() or sessionStopped().

See Also: completed(), totalRuns(), allRuns(), failedRuns()

int totalRuns ( void ) const

Number of runs of this RePro which did not fail since last call of sessionStarted() or sessionStopped(). i.e. where main() returned Aborted or Completed.

See Also: completeRuns(), allRuns(), failedRuns()

int allRuns ( void ) const

Number of runs of this RePro since last call of sessionStarted() or sessionStopped().

See Also: completeRuns(), totalRuns(), failedRuns()

Referenced by SaveFiles::save().

int failedRuns ( void ) const

Number of runs of this RePro which failed (main() returned Failed) since last call of sessionStarted() or sessionStopped().

See Also: completeRuns(), totalRuns(), allRuns()

double reproTime ( void ) const

Time in seconds this RePro is currently running.

See Also: reproTimeStr()

Referenced by RePro::reproTimeStr().

string reproTimeStr ( void ) const

A string displaying the elapsed time of the current RePro.

See Also: reproTime()

References relacs::floor(), Str::format(), RELACSPlugin::lockRelacsSettings(), relacs::min(), RELACSPlugin::relacsSettings(), RePro::reproTime(), Options::text(), and RELACSPlugin::unlockRelacsSettings().

double reproStartTime ( void ) const

The time of the session when the RePro was started in seconds.

int testWrite ( OutData & signal )

Test of a single output signal signal for validity. Returns 0 on success or a negative number if signal is not valid. The error state of signal is set appropriately.

References RELACSPlugin::RW, and Acquire::testWrite().

int testWrite ( OutList & signal )

Test of a multiple output signals signal for validity. Returns 0 on success or a negative number if signal is not valid. The error state of signal is set appropriately.

References RELACSPlugin::RW, and Acquire::testWrite().

int write	(	OutData &	signal,
		bool	setsignaltime = `true`
	)

Blocking output of a signal signal. The function blocks until the output of the signal finished. See OutData about how to specify output channel, sampling rate, intensity, delay, etc.

Parameters

[in]	signal	The signal to be written out on an analog output.
[in]	setsignal	if set `true` (default) then the start time of this signal is recorded.

Returns: 0 on success. If the output of the signal failed, a negative number is returned and the reason is specified in the error state of signal.

References RELACSPlugin::getData(), SampleData< T >::length(), ConfigDialog::lock(), RELACSPlugin::RW, RELACSPlugin::signalTime(), ConfigDialog::unlock(), and RELACSWidget::write().

int write	(	OutList &	signal,
		bool	setsignaltime = `true`
	)

Blocking output of multiple signals signal. The function blocks until the output of the signal finished. See OutList about how to specify output channel, sampling rate, intensity, delay, etc.

Parameters

[in]	signal	The signals to be written out on analog outputs.
[in]	setsignal	if set `true` (default) then the start time of this signal is recorded.

Returns: 0 on success. If the output of the signal failed, a negative number is returned and the reason is specified in the error state of signal.

References RELACSPlugin::getData(), ConfigDialog::lock(), OutList::maxLength(), RELACSPlugin::RW, RELACSPlugin::signalTime(), ConfigDialog::unlock(), and RELACSWidget::write().

int startWrite	(	OutData &	signal,
		bool	setsignaltime = `true`
	)

Non-blocking output of a signal signal. The function returns immediately after signal output has been initiated. See OutData about how to specify output channel, sampling rate, intensity, delay, etc.

Parameters

[in]	signal	The signal to be written out on an analog output.
[in]	setsignal	if set `true` (default) then the start time of this signal is recorded.

Returns: 0 on success. If the output of the signal failed, a negative number is returned and the reason is specified in the error state of signal.

Note: During the output of the stimulus, signal must exist and must not be modified!

References RELACSPlugin::RW, and RELACSWidget::write().

int startWrite	(	OutList &	signal,
		bool	setsignaltime = `true`
	)

Non-blocking output of multiple signals signal. The function returns immediately after signal output has been initiated. See OutList about how to specify output channel, sampling rate, intensity, delay, etc.

Parameters

[in]	signal	The signals to be written out on analog outputs.
[in]	setsignal	if set `true` (default) then the start time of the signals is recorded.

Returns: 0 on success. If the output of the signal failed, a negative number is returned and the reason is specified in the error state of signal.

Note: During the output of the stimulus, signal must exist and must not be modified!

References RELACSPlugin::RW, and RELACSWidget::write().

int directWrite	(	OutData &	signal,
		bool	setsignaltime = `true`
	)

Direct output of a single data value as specified by signal to the DAQ board. Only the output trace ( OutData::setTrace() ) or the the name of the output trace ( OutData::setTraceName() ), as well as the single data value need to be specified. If setsignal is set true (default) then the start time of this signal is recorded.

Returns: 0 on success, a negative number if the output of the signal failed. The reason for the failure is specified in the error state of signal.

References RELACSWidget::directWrite(), and RELACSPlugin::RW.

int directWrite	(	OutList &	signal,
		bool	setsignaltime = `true`
	)

Direct output of single data values as specified by signal to different channels of the DAQ board. Only the output traces ( OutData::setTrace() ) or the the name of the output traces ( OutData::setTraceName() ), as well as the single data values need to be specified. If setsignal is set true (default) then the start time of this signal is recorded.

Returns: 0 on success, a negative number if the output of the signals failed. The reason for the failure is specified in the error state of signal.

References RELACSWidget::directWrite(), and RELACSPlugin::RW.

int writeZero	(	int	channel,
		int	device
	)

Set the output of channel channel on device device to zero. Returns 0 on success or a negative number on error. If device is negative, the default device is used.

References RELACSPlugin::RW, and Acquire::writeZero().

int writeZero ( int index )

Set the output of the trace with index index to zero. Returns 0 on success or a negative number on error.

References RELACSPlugin::RW, and Acquire::writeZero().

int writeZero ( const string & trace )

Set the output of the trace with name trace to zero. Returns 0 on success or a negative number on error.

References RELACSPlugin::RW, and Acquire::writeZero().

int stopWrite ( void )

Stop analog output of all analog output devices.

References RELACSPlugin::RW, and RELACSWidget::stopWrite().

Referenced by RePro::requestStop().

double minLevel ( int trace ) const

Returns the minimum possible attenuation level for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then OutData::NoLevel is returned.

See Also: maxLevel()

References Acquire::minLevel(), and RELACSPlugin::RW.

double minLevel ( const string & trace ) const

Returns the minimum possible attenuation level for output trace with name trace.

References Acquire::minLevel(), and RELACSPlugin::RW.

double maxLevel ( int trace ) const

Returns the maximum possible attenuation level for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then OutData::NoLevel is returned.

See Also: minLevel()

References Acquire::maxLevel(), and RELACSPlugin::RW.

double maxLevel ( const string & trace ) const

Returns the maximum possible attenuation level for output trace with name trace.

References Acquire::maxLevel(), and RELACSPlugin::RW.

void levels	(	int	trace,
		vector< double > &	l
	)		const

Returns in l all possible attenuation levels sorted by increasing attenuation levels (highest last) for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then l is returned empty.

See Also: minLevel(), maxLevel()

References Acquire::levels(), and RELACSPlugin::RW.

void levels	(	const string &	trace,
		vector< double > &	l
	)		const

Returns in l all possible attenuation levels sorted by increasing attenuation levels (highest last) for the output trace with name trace.

References Acquire::levels(), and RELACSPlugin::RW.

double minIntensity	(	int	trace,
		double	frequency = `0.0`
	)		const

Returns the minimum possible intensity at the given stimulus frequency for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then OutData::NoIntensity is returned.

See Also: maxIntensity(), minLevel(), maxLevel()

References Acquire::minIntensity(), and RELACSPlugin::RW.

double minIntensity	(	const string &	trace,
		double	frequency = `0.0`
	)		const

Returns the minimum possible intensity for output trace with name trace.

References Acquire::minIntensity(), and RELACSPlugin::RW.

double maxIntensity	(	int	trace,
		double	frequency = `0.0`
	)		const

Returns the maximum possible intensity at the given stimulus frequency for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then OutData::NoIntensity is returned.

See Also: minIntensity(), minLevel(), maxLevel()

References Acquire::maxIntensity(), and RELACSPlugin::RW.

double maxIntensity	(	const string &	trace,
		double	frequency = `0.0`
	)		const

Returns the maximum possible intensity for output trace with name trace.

References Acquire::maxIntensity(), and RELACSPlugin::RW.

void intensities	(	int	trace,
		vector< double > &	ints,
		double	frequency = `0.0`
	)		const

Returns in ints all possible intensities at the given stimulus frequency sorted by increasing intensities for the output trace at index trace. If trace is invalid or trace is not connected to an attenuator then intens is returned empty.

See Also: minIntensity(), maxIntensity()

References Acquire::intensities(), and RELACSPlugin::RW.

void intensities	(	const string &	trace,
		vector< double > &	ints,
		double	frequency = `0.0`
	)		const

Returns in ints all possible intensities at the given stimulus frequency sorted by increasing intensities for the output trace with name trace.

References Acquire::intensities(), and RELACSPlugin::RW.

void setMessage ( bool message = true )

Print the default messages if message is true. This is the default.

See Also: noMessage(), message()

References RePro::message().

void noMessage ( void )

Do not print any of the default messages.

See Also: setMessage(), message()

Referenced by DefaultRePro::main().

void message ( const string & msg )

Write a message msg in the right half of the status line.

See Also: setMessage(), noMessage()

References RePros::message(), and RELACSPlugin::repros().

Referenced by RePro::setMessage().

string addPath ( const string & file ) const

Stores file in the list of files for this run of the RePro.

Returns: file added to the base path for the current session.

References SaveFiles::addPath(), RELACSPlugin::RW, and SaveFiles::storeFile().

void keepFocus ( void )

Call this function in the beginning of the main() function, if your implementation includes some interactive widgets and you do not want RELACS to automatically remove the keyboard focus from these widgets after some timeout.

References RELACSPlugin::RW, KeyTimeOut::setNoFocusWidget(), and RELACSPlugin::widget().

void grabKey ( int key )

Add key to the list of keys that are forced to be passed to keyPressEvent(). You need to handle this key event in a reimplementation of keyPressEvent().

void releaseKey ( int key )

Remove key from the list of keys that are forced to be passed to keyPressEvent().

References Options::empty(), and RePro::releaseKeys().

void releaseKeys ( void )

Empty the list of keys that are forced to be passed to keyPressEvent().

Referenced by RePro::customEvent(), and RePro::releaseKey().

int softStop ( void )

How many requests to stop the repro are there since the RePro was started?

See Also: setSoftStop(), clearSoftStop(), setSoftStopKey()

void setSoftStop ( int s = 1 )

Set the number of requested stops for the repro to s.

See Also: softStop(), clearSoftStop(), setSoftStopKey()

void clearSoftStop ( void )

Set the number of requested stops for the repro to zero.

See Also: softStop(), setSoftStop(), setSoftStopKey()

void setSoftStopKey ( int keycode )

Set the keycode initiating a soft stop to keycode.

See Also: softStop(), setSoftStop(), clearSoftStop()

void tracePlotOn ( bool on = true )

Switch plotting of raw traces on (on = true, default) or off (off = false).

See Also: tracePlotOff(), tracePlotSignal(), tracPlotContinuous()

References RELACSPlugin::RW, and PlotTrace::setPlotOn().

void tracePlotOff ( void )

Switch plotting of raw traces off.

See Also: tracePlotOn(), tracePlotSignal(), tracPlotContinuous()

References RELACSPlugin::RW, and PlotTrace::setPlotOff().

void tracePlotSignal	(	double	length,
		double	offs = `0.0`
	)

Raw traces are plotted relative to the beginning of the last output signal in a window of length seconds width. The start time of the signal is offs seconds from the left margin of that window.

See Also: tracePlotOn(), tracPlotContinuous()

References RELACSPlugin::RW, and PlotTrace::setPlotNextSignal().

void tracePlotSignal ( void )

Raw traces are plotted relative to the beginning of the last output signal. The width of the plot window is not changed.

See Also: tracePlotOn(), tracPlotContinuous()

References RELACSPlugin::RW, and PlotTrace::setPlotNextSignal().

void tracePlotContinuous ( double length )

Raw traces are plotted continuously in a window of length seconds width.

See Also: tracePlotOn(), tracPlotSignal()

References RELACSPlugin::RW, and PlotTrace::setPlotContinuous().

void tracePlotContinuous ( void )

Raw traces are plotted continuously. The width of the plot window is not changed.

See Also: tracePlotOn(), tracPlotSignal()

References RELACSPlugin::RW, and PlotTrace::setPlotContinuous().

Referenced by DefaultRePro::main().

string macroName ( void )

Return the name of the currently running macro. If the RePro was called from the RePro menu then "RePro" is returned.

References RePros::macroName(), and RELACSPlugin::repros().

string macroParam ( void )

Return the parameters of the currently running macro.

References RePros::macroParam(), and RELACSPlugin::repros().

string reproPath ( bool version = true )

Return a path where the RePro can store some global stuff. This is the repropath from the RELACS settings plus the name of the RePro. If version is true, a subdirectory is created for each version of the RePro.

See Also: addReProPath()

References Str::find(), Str::left(), RELACSPlugin::lockRelacsSettings(), Str::lower(), ConfigDialog::name(), RELACSPlugin::path(), Str::provideSlash(), RELACSPlugin::relacsSettings(), Options::text(), RELACSPlugin::unlockRelacsSettings(), and ConfigDialog::version().

Referenced by RePro::addReProPath().

string addReProPath	(	const string &	file,
		bool	version = `true`
	)

Returns file added to the reproPath().

See Also: reProPath()

References RePro::reproPath().

void dialog ( void )

virtual

This function is called to set the options of the RePro. A standard dialog (OptDialog) is launched to set the repro's options. Reimplement it, if you want another interface.

Reimplemented from ConfigDialog.

Referenced by ReProData::dialog(), and MacroCommand::dialog().

Options & overwriteOptions ( void )

Options of the RePro that overwrite macro options.

Referenced by ReProData::acceptDialog(), MacroCommand::acceptDialog(), MacroCommand::dialog(), and MacroCommand::execute().

string checkOptions ( const string & opttxt )

Check for valid options.

Parameters

[in] opttxt string with options that are tesed for validity

Returns: error message

References Options::read(), and Options::warning().

Referenced by MacroCommand::checkOptions().

void setSaving ( bool saving )

virtual

Determine whether data (voltage traces and event lists) of this run of the RePro should be saved to disk. Only during a running session, data can be saved to disk. By default, data are saved to disk.

Note: Call this function at the very beginning of your main() code, i.e. before writing any stimulus, if you want to save nothing during the run of the RePro.

See Also: SaveFiles::writing(), noSaving()

References RELACSPlugin::RW, and SaveFiles::save().

Referenced by RePro::noSaving(), RELACSWidget::startRePro(), and RELACSWidget::stopSession().

void noSaving ( void )

Indicate that the data of this RePro don't have to be saved to disk.

Note: Call this function at the very beginning of your main() code, i.e. before writing any stimulus, if you want to save nothing during the run of the RePro. Shortcut for setSaving( false ).

References RePro::setSaving().