Squidstat API User Manual
Loading...
Searching...
No Matches
AisExperiment Class Referencefinal

this class is used to create custom experiments. A custom experiment contains one or more elements. Once you create elements and set their parameters, you can add them to the container. More...

#include <AisExperiment.h>

Public Member Functions

 AisExperiment ()
 this is the default constructor for the custom experiment.
 
 AisExperiment (const AisExperiment &exp)
 this is the copy constructor for the custom experiment. More...
 
void operator= (const AisExperiment &exp)
 the assignment operator for the custom experiment. More...
 
QString getExperimentName () const
 get the name of the custom experiment. More...
 
QString getDescription () const
 get a brief description of the custom experiment. More...
 
QStringList getCategory () const
 get the category for the custom experiment. More...
 
void setExperimentName (QString name)
 set a name for the custom experiment. More...
 
void setDescription (QString description)
 set a description for the experiment. More...
 
bool appendElement (AisAbstractElement &element, unsigned int repeat=1)
 append an element to the custom experiment. More...
 
bool appendSubExperiment (const AisExperiment &subExp, unsigned int repeat=1)
 append a sub experiment to this/(the calling) custom experiment. More...
 

Friends

class AisInstrumentHandler
 

Detailed Description

this class is used to create custom experiments. A custom experiment contains one or more elements. Once you create elements and set their parameters, you can add them to the container.

Note
we call the basic experiments -that are used to build more complex custom experiments- elements. In contexts where both elements and custom experiments are used, elements will be referred to as elements to make the distinction. In other contexts, elements may also be referred to as experiments as they may indeed be used as experiments.

Constructor & Destructor Documentation

◆ AisExperiment()

AisExperiment::AisExperiment ( const AisExperiment exp)
explicit

this is the copy constructor for the custom experiment.

Parameters
expthe custom experiment to copy from.

Member Function Documentation

◆ appendElement()

bool AisExperiment::appendElement ( AisAbstractElement &  element,
unsigned int  repeat = 1 
)

append an element to the custom experiment.

Parameters
elementan elemental experiment to be appended to this/(the calling) custom experiment.
repeatthe number of times this element is to be repeated. This is an optional parameter and is defaulted to equal 1 when not set.
Returns
true if appending the element was successful and false otherwise.
Note
although an element is an experiment, in the context of custom experiments, it is referred to as an element to make a distinction between the two. In other contexts where such distinction is not needed, an element may still be referred to as an experiment.

◆ appendSubExperiment()

bool AisExperiment::appendSubExperiment ( const AisExperiment subExp,
unsigned int  repeat = 1 
)

append a sub experiment to this/(the calling) custom experiment.

Parameters
subExpa sub experiment to be appended to this/(the calling) custom experiment.
repeatthe number of times this sub experiment is to be repeated. This is an optional parameter and is defaulted to equal 1 when not set.
Returns
true if appending the sub experiment was successful and false otherwise.

◆ getCategory()

QStringList AisExperiment::getCategory ( ) const

get the category for the custom experiment.

Returns
the category set for the custom experiment. If no category has been set, the default category returned is ("Custom").

◆ getDescription()

QString AisExperiment::getDescription ( ) const

get a brief description of the custom experiment.

Returns
the description set for the custom experiment. If no description has been set, the default description returned is "Not Defined".

◆ getExperimentName()

QString AisExperiment::getExperimentName ( ) const

get the name of the custom experiment.

Returns
the name set for the custom experiment. If no name has been set, the default name returned is "Custom Experiment"

◆ operator=()

void AisExperiment::operator= ( const AisExperiment exp)

the assignment operator for the custom experiment.

Parameters
expthe custom experiment to copy from.

◆ setDescription()

void AisExperiment::setDescription ( QString  description)

set a description for the experiment.

Parameters
descriptionthe description to be set for the custom experiment.

◆ setExperimentName()

void AisExperiment::setExperimentName ( QString  name)

set a name for the custom experiment.

Parameters
namethe name to be set for the custom experiment.

The documentation for this class was generated from the following file: