copasi API  0.1
Classes | Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Attributes
CCopasiTask Class Reference

#include <CCopasiTask.h>

Inheritance diagram for CCopasiTask:
CCopasiContainer CCopasiObject CCrossSectionTask CEFMTask CLyapTask CMCATask CMoietiesTask COptTask CScanTask CSensTask CSteadyStateTask CTrajectoryTask CTSSATask

List of all members.

Classes

class  CDescription
class  CResult

Public Types

enum  Type {
  steadyState = 0, timeCourse, scan, fluxMode,
  optimization, parameterFitting, mca, lyap,
  tssAnalysis, sens, moieties, crosssection,
  unset
}
enum  eOutputFlagBase {
  INITIALIZE = 0x01, STREAM = 0x02, FINISH = 0x04, REPORT = 0x10,
  PLOT = 0x20, TIME_SERIES = 0x40
}
enum  OutputFlag { NO_OUTPUT = 0, OUTPUT = REPORT | PLOT | TIME_SERIES | STREAM, OUTPUT_COMPLETE = REPORT | PLOT | TIME_SERIES | INITIALIZE | STREAM | FINISH, ONLY_TIME_SERIES = TIME_SERIES | INITIALIZE | STREAM | FINISH }

Public Member Functions

 CCopasiTask (const std::string &name="NoName", const CCopasiContainer *pParent=NULL, const std::string &type="Task")
 CCopasiTask (const Type &taskType, const CCopasiContainer *pParent=NULL, const std::string &type="Task")
 CCopasiTask (const CCopasiTask &src, const CCopasiContainer *pParent=NULL)
virtual ~CCopasiTask ()
Type getType () const
void setType (const Type &type)
virtual const std::string & getKey () const
void setScheduled (const bool &scheduled)
const bool & isScheduled () const
void setUpdateModel (const bool &updateModel)
const bool & isUpdateModel () const
virtual bool setCallBack (CProcessReport *pCallBack)
CProcessReportgetCallBack () const
virtual bool updateMatrices ()
virtual bool initialize (const OutputFlag &of, COutputHandler *pOutputHandler, std::ostream *pOstream)
virtual bool process (const bool &useInitialValues)
virtual bool restore ()
CCopasiProblemgetProblem ()
const CCopasiProblemgetProblem () const
virtual bool setMethodType (const int &type)
CCopasiMethodgetMethod ()
const CCopasiMethodgetMethod () const
CReportgetReport ()
const CDescriptiongetDescription () const
const CResultgetResult () const
void cleanup ()
CCopasiParameterGroupgetSliders ()
virtual void output (const COutputInterface::Activity &activity)
virtual void separate (const COutputInterface::Activity &activity)
const OutputFlaggetOutputMode () const
COutputHandlergetOutputHandler () const

Static Public Member Functions

static bool isValidMethod (const unsigned C_INT32 &method, const unsigned C_INT32 *validMethods)

Static Public Attributes

static const std::string TypeName []
static const char * XMLType []
static const unsigned C_INT32 ValidMethods []

Protected Attributes

Type mType
std::string mKey
CDescription mDescription
CResult mResult
bool mScheduled
bool mUpdateModel
CStatempInitialState
CCopasiProblemmpProblem
CCopasiMethodmpMethod
CReport mReport
CProcessReportmpCallBack
CCopasiParameterGroupmpSliders
OutputFlag mDoOutput
COutputHandlermpOutputHandler
unsigned C_INT32 mOutputCounter

Member Enumeration Documentation

Enumerator:
INITIALIZE 
STREAM 
FINISH 
REPORT 
PLOT 
TIME_SERIES 
Enumerator:
NO_OUTPUT 
OUTPUT 
OUTPUT_COMPLETE 
ONLY_TIME_SERIES 

Enumeration of the types of tasks known to COPASI.

Enumerator:
steadyState 
timeCourse 
scan 
fluxMode 
optimization 
parameterFitting 
mca 
lyap 
tssAnalysis 
sens 
moieties 
crosssection 
unset 

Constructor & Destructor Documentation

CCopasiTask::CCopasiTask ( const std::string &  name = "NoName",
const CCopasiContainer pParent = NULL,
const std::string &  type = "Task" 
)

Default constructor

CCopasiTask::CCopasiTask ( const Type taskType,
const CCopasiContainer pParent = NULL,
const std::string &  type = "Task" 
)

Specific constructor

Parameters:
constType & taskType
constCCopasiContainer * pParent (default: NULL)
conststd::string & type (default: "Task")
CCopasiTask::CCopasiTask ( const CCopasiTask src,
const CCopasiContainer pParent = NULL 
)

Copy constructor

Parameters:
constCCopasiTask & src
constCCopasiContainer * pParent (default: NULL)
CCopasiTask::~CCopasiTask ( ) [virtual]

Destructor


Member Function Documentation

void CCopasiTask::cleanup ( )

Cleanup function

Reimplemented in CScanTask, COptTask, and CFitTask.

CProcessReport * CCopasiTask::getCallBack ( ) const
const CCopasiTask::CDescription & CCopasiTask::getDescription ( ) const

Retrieve the description

const std::string & CCopasiTask::getKey ( ) const [virtual]

Retrieve the key for the task.

Returns:
std::string key

Reimplemented from CCopasiObject.

CCopasiMethod * CCopasiTask::getMethod ( )

Retrieve the method

const CCopasiMethod * CCopasiTask::getMethod ( ) const

Retrieve the method

COutputHandler * CCopasiTask::getOutputHandler ( ) const
const OutputFlag& CCopasiTask::getOutputMode ( ) const [inline]
CCopasiProblem * CCopasiTask::getProblem ( )

Retrieve the problem

const CCopasiProblem * CCopasiTask::getProblem ( ) const

Retrieve the problem

CReport & CCopasiTask::getReport ( )

Retrieve the report

const CCopasiTask::CResult & CCopasiTask::getResult ( ) const

Retrieve the result

Reimplemented in CSteadyStateTask.

CCopasiParameterGroup * CCopasiTask::getSliders ( )

Retrieve a pointer to the group of sliders.

Returns:
CCopasiParameterGroup * pSliders
CCopasiTask::Type CCopasiTask::getType ( void  ) const

Retrieve the type of the task

Returns:
CCopasiTask::Type type
bool CCopasiTask::initialize ( const OutputFlag of,
COutputHandler pOutputHandler,
std::ostream *  pOstream 
) [virtual]

Initialize the task. If an ostream is given this ostream is used instead of the target specified in the report. This allows nested tasks to share the same output device.

Parameters:
constOutputFlag & of
COutputHandler* pOutputHandler
std::ostream* pOstream (default: NULL)
Returns:
bool success

Reimplemented in CSteadyStateTask, CTrajectoryTask, CScanTask, CLyapTask, CTSSATask, CMCATask, CEFMTask, COptTask, CFitTask, CSensTask, CMoietiesTask, and CCrossSectionTask.

const bool & CCopasiTask::isScheduled ( ) const

Check whether the task is scheduled

Returns:
const bool & scheduled
const bool & CCopasiTask::isUpdateModel ( ) const

Check whether the task must update the model

Returns:
const bool & updateModel
bool CCopasiTask::isValidMethod ( const unsigned C_INT32 &  method,
const unsigned C_INT32 *  validMethods 
) [static]

Check whether the given method is in the list of valid methods This list must end with CCopasiMethod::unset

Parameters:
constunsigned C_INT32 & method
constunsigned C_INT32 * validMethods
Returns:
bool isValid

Reimplemented in CEFMTask.

void CCopasiTask::output ( const COutputInterface::Activity activity) [virtual]

Perform an output event for the current activity

Parameters:
constActivity & activity
bool CCopasiTask::process ( const bool &  useInitialValues) [virtual]

Process the task with or without initializing to the initial state.

Parameters:
constbool & useInitialValues
Returns:
bool success

Reimplemented in CSteadyStateTask, CTrajectoryTask, CScanTask, CLyapTask, CTSSATask, CMCATask, CEFMTask, COptTask, CFitTask, CSensTask, CMoietiesTask, and CCrossSectionTask.

bool CCopasiTask::restore ( ) [virtual]

Perform necessary cleanup procedures

Reimplemented in CSteadyStateTask, CTrajectoryTask, CTSSATask, CLyapTask, CMCATask, and CFitTask.

void CCopasiTask::separate ( const COutputInterface::Activity activity) [virtual]

Introduce an additional separator into the output

Parameters:
constActivity & activity
bool CCopasiTask::setCallBack ( CProcessReport pCallBack) [virtual]

Set the call back of the task

Parameters:
CProcessReport* pCallBack
Returns:
bool success

Reimplemented in CEFMTask, COptTask, CFitTask, and CMoietiesTask.

bool CCopasiTask::setMethodType ( const int &  type) [virtual]

Set the method type applied to solve the task

Parameters:
constCCopasiMethod::SubType & type
Returns:
bool success

Reimplemented in CLyapTask, CTrajectoryTask, CTSSATask, CEFMTask, COptTask, CFitTask, and CMoietiesTask.

void CCopasiTask::setScheduled ( const bool &  scheduled)

Set whether the task is scheduled

Parameters:
constbool & scheduled
void CCopasiTask::setType ( const Type type)

Set the type of the task

Parameters:
CCopasiTask::Type& type
void CCopasiTask::setUpdateModel ( const bool &  updateModel)

Set whether the task must update the model

Parameters:
constbool & updateModel
virtual bool CCopasiTask::updateMatrices ( ) [inline, virtual]

Resizes result matrices and updates array annotations for a specific task. For now this will be hard coded in the respective derived classes. We may introduce a more generic mechanism for this in the future. This is used when we need to know about the data structures of a task result without actually performing the task, e.g. when selecting objects for output. For now we assume that this functionality is also performed when initialize() is called.

Reimplemented in CSteadyStateTask, CMCATask, and CSensTask.


Member Data Documentation

The description of the task.

std::string CCopasiTask::mKey [protected]

The key of the task

unsigned C_INT32 CCopasiTask::mOutputCounter [protected]

progress bar handler

The state of the model before execution of the task. If mUpdateModel is false this state is restored.

The method used to solve the problem.

The problem of the task

Pointer to group of sliders associated with the task.

The report that belongs to this specific task

The result of the task.

bool CCopasiTask::mScheduled [protected]

Tells whether the task is scheduled for execution

Type CCopasiTask::mType [protected]

The type of the task

bool CCopasiTask::mUpdateModel [protected]

Tells whether the task shall update the model with the result. The restore method must act accordingly.

const std::string CCopasiTask::TypeName [static]
Initial value:
{
  "Steady-State",
  "Time-Course",
  "Scan",
  "Elementary Flux Modes",
  "Optimization",
  "Parameter Estimation",
  "Metabolic Control Analysis",
  "Lyapunov Exponents",
  "Time Scale Separation Analysis",


 
  "Sensitivities",
  "Moieties",
  "Cross Section",
  ""
}

String literals for the GUI to display type names of tasks known to COPASI.

CCopasiTask class. This class is used to describe a task in COPASI. This class is intended to be used as the parent class for all tasks within COPASI.

Created for COPASI by Stefan Hoops 2003

const unsigned C_INT32 CCopasiTask::ValidMethods [static]
Initial value:

The methods which can be selected for performing this task.

Reimplemented in CTrajectoryTask, COptTask, CTSSATask, CEFMTask, and CMoietiesTask.

const char * CCopasiTask::XMLType [static]
Initial value:
{
  "steadyState",
  "timeCourse",
  "scan",
  "fluxMode",
  "optimization",
  "parameterFitting",
  "metabolicControlAnalysis",
  "lyapunovExponents",
  "timeScaleSeparationAnalysis",


 
  "sensitivities",
  "moieties",
  "crosssection",
  NULL
}

XML type names of tasks known to COPASI.


The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines