Algorithm Class Reference

#include <GaudiKernel/Algorithm.h>

Inheritance diagram for Algorithm:

[legend]

Collaboration diagram for Algorithm:

[legend]

List of all members.

---

Detailed Description

Base class from which all concrete algorithm classes should be derived.

In order for a concrete algorithm class to do anything useful the methods initialize(), execute() and finalize() should be overridden.

The base class provides utility methods for accessing standard services (event data service etc.); for declaring properties which may be configured by the job options service; and for creating sub algorithms. The only base class functionality which may be used in the constructor of a concrete algorithm is the declaration of member variables as properties. All other functionality, i.e. the use of services and the creation of sub-algorithms, may be used only in initialize() and afterwards (see the Gaudi user guide).

Author:

Paul Maley

Pere Mato

David Quarrie

Date:

1998

Definition at line 61 of file Algorithm.h.

Public Member Functions
	Algorithm (const std::string &name, ISvcLocator *svcloc, const std::string &version=PACKAGE_VERSION)
	Constructor.
virtual	~Algorithm ()
	Destructor.
virtual StatusCode	sysStart ()
	Reinitialization method invoked by the framework.
virtual StatusCode	sysInitialize ()
	Initialization method invoked by the framework.
virtual StatusCode	sysReinitialize ()
	Reinitialization method invoked by the framework.
virtual StatusCode	sysRestart ()
	Restart method invoked by the framework.
virtual StatusCode	sysExecute ()
	The actions to be performed by the algorithm on an event.
virtual StatusCode	sysStop ()
	System stop.
virtual StatusCode	sysFinalize ()
	System finalization.
virtual StatusCode	sysBeginRun ()
	beginRun method invoked by the framework.
virtual StatusCode	sysEndRun ()
	endRun method invoked by the framework.
virtual const std::string &	name () const
	The identifying name of the algorithm object.
virtual const std::string &	version () const
virtual StatusCode	configure ()
	Dummy implementation of IStateful::configure() method.
virtual StatusCode	terminate ()
	Dummy implementation of IStateful::terminate() method.
virtual StatusCode	initialize ()
	the default (empty) implementation of IStateful::initialize() method
virtual StatusCode	start ()
	the default (empty) implementation of IStateful::start() method
virtual StatusCode	stop ()
	the default (empty) implementation of IStateful::stop() method
virtual StatusCode	finalize ()
	the default (empty) implementation of IStateful::finalize() method
virtual StatusCode	reinitialize ()
	the default (empty) implementation of IStateful::reinitialize() method
virtual StatusCode	restart ()
	the default (empty) implementation of IStateful::restart() method
virtual bool	isExecuted () const
	Has this algorithm been executed since the last reset?
virtual void	setExecuted (bool state)
	Set the executed flag to the specified state.
virtual void	resetExecuted ()
	Reset the executed state of the Algorithm for the duration of the current event.
virtual StatusCode	beginRun ()
	Algorithm begin run.
virtual StatusCode	endRun ()
	Algorithm end run. This method is called at the end of the event loop.
virtual Gaudi::StateMachine::State	FSMState () const
	returns the current state of the algorithm
virtual Gaudi::StateMachine::State	targetFSMState () const
	returns the state the algorithm will be in after the ongoing transition
virtual bool	isEnabled () const
	Is this algorithm enabled or disabled?
virtual bool	filterPassed () const
	Did this algorithm pass or fail its filter criterion for the last event?
virtual void	setFilterPassed (bool state)
	Set the filter passed flag to the specified state.
template<class T>
StatusCode	service (const std::string &name, T *&psvc, bool createIf=true) const
	Access a service by name, creating it if it doesn't already exist.
template<class T>
StatusCode	service (const std::string &svcType, const std::string &svcName, T *&psvc) const
	Access a service by name and type, creating it if it doesn't already exist.
SmartIF< IService >	service (const std::string &name, const bool createIf=true, const bool quiet=false) const
	Return a pointer to the service identified by name (or "type/name").
void	setOutputLevel (int level)
	Set the output level for current algorithm.
SmartIF< IAuditorSvc > &	auditorSvc () const
	The standard auditor service.May not be invoked before sysInitialize() has been invoked.
SmartIF< IChronoStatSvc > &	chronoSvc () const
	The standard Chrono & Stat service, Return a pointer to the service if present.
SmartIF< IChronoStatSvc > &	chronoStatService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IDataProviderSvc > &	detSvc () const
	The standard detector data service.
SmartIF< IDataProviderSvc > &	detDataService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IConversionSvc > &	detCnvSvc () const
	The standard detector data persistency conversion service.
SmartIF< IConversionSvc > &	detDataCnvService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IDataProviderSvc > &	eventSvc () const
	The standard event data service.
SmartIF< IDataProviderSvc > &	evtSvc () const
	shortcut for method eventSvc
SmartIF< IDataProviderSvc > &	eventDataService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IConversionSvc > &	eventCnvSvc () const
	The standard event data persistency conversion service.
SmartIF< IConversionSvc > &	eventDataCnvService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IHistogramSvc > &	histoSvc () const
	The standard histogram service.
SmartIF< IHistogramSvc > &	histogramDataService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service.
SmartIF< IMessageSvc > &	messageService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< INTupleSvc > &	ntupleSvc () const
	The standard N tuple service.
SmartIF< INTupleSvc > &	ntupleService () const
	Obsoleted name, kept due to the backwards compatibility.
SmartIF< IRndmGenSvc > &	randSvc () const
	AIDA-based NTuple service Returns a pointer to the AIDATuple service if present.
SmartIF< IToolSvc > &	toolSvc () const
	The standard ToolSvc service, Return a pointer to the service if present.
SmartIF< IExceptionSvc > &	exceptionSvc () const
	Get the exception Service.
SmartIF< ISvcLocator > &	serviceLocator () const
	The standard service locator.
SmartIF< ISvcLocator > &	svcLoc () const
	shortcut for method serviceLocator
StatusCode	createSubAlgorithm (const std::string &type, const std::string &name, Algorithm *&pSubAlg)
	Create a sub algorithm.
std::vector< Algorithm * > *	subAlgorithms () const
	List of sub-algorithms. Returns a pointer to a vector of (sub) Algorithms.
virtual StatusCode	setProperty (const Property &p)
	Implementation of IProperty::setProperty.
virtual StatusCode	setProperty (const std::string &s)
	Implementation of IProperty::setProperty.
virtual StatusCode	setProperty (const std::string &n, const std::string &v)
	Implementation of IProperty::setProperty.
virtual StatusCode	getProperty (Property *p) const
	Implementation of IProperty::getProperty.
virtual const Property &	getProperty (const std::string &name) const
	Implementation of IProperty::getProperty.
virtual StatusCode	getProperty (const std::string &n, std::string &v) const
	Implementation of IProperty::getProperty.
virtual const std::vector < Property * > &	getProperties () const
	Implementation of IProperty::getProperties.
StatusCode	setProperties ()
	Set the algorithm's properties.
template<class T>
Property *	declareProperty (const std::string &name, T &property, const std::string &doc="none") const
	Declare the named property.
Property *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
	Declare remote named properties.
SmartIF< IMonitorSvc > &	monitorSvc () const
	Access the monitor service.
template<class T>
void	declareInfo (const std::string &name, const T &var, const std::string &desc) const
	Declare monitoring information.
void	declareInfo (const std::string &name, const std::string &format, const void *var, int size, const std::string &desc) const
	Declare monitoring information (special case).
template<class TYPE>
StatusCode	setProperty (const std::string &name, const TYPE &value)
	set the property form the value
Protected Member Functions
bool	isInitialized () const
	Has the Algorithm already been initialized?
bool	isFinalized () const
	Has the Algorithm already been finalized?
int	outputLevel () const
	retrieve the Algorithm output level
IntegerProperty &	outputLevelProperty ()
	Accessor for the Message level property.
void	initOutputLevel (Property &prop)
	callback for output level property
Private Member Functions
StatusCode	service_i (const std::string &svcName, bool createIf, const InterfaceID &iid, void **ppSvc) const
	implementation of service method
StatusCode	service_i (const std::string &svcType, const std::string &svcName, const InterfaceID &iid, void **ppSvc) const
	Algorithm (const Algorithm &a)
	Private Copy constructor: NO COPY ALLOWED.
Algorithm &	operator= (const Algorithm &rhs)
	Private assignment operator: NO ASSIGNMENT ALLOWED.
Private Attributes
std::string	m_name
	Algorithm's name for identification.
std::string	m_version
	Algorithm's version.
std::vector< Algorithm * > *	m_subAlgms
	Sub algorithms.
SmartIF< IMessageSvc >	m_MS
	Message service.
SmartIF< IDataProviderSvc >	m_EDS
	Event data service.
SmartIF< IConversionSvc >	m_ECS
	Event conversion service.
SmartIF< IDataProviderSvc >	m_DDS
	Detector data service.
SmartIF< IConversionSvc >	m_DCS
	Detector conversion service.
SmartIF< IHistogramSvc >	m_HDS
	Histogram data service.
SmartIF< INTupleSvc >	m_NTS
	N tuple service.
SmartIF< IChronoStatSvc >	m_CSS
	Chrono & Stat Service.
SmartIF< IRndmGenSvc >	m_RGS
	Random Number Generator Service.
SmartIF< IExceptionSvc >	m_EXS
	Exception Handler Service.
SmartIF< IAuditorSvc >	m_pAuditorSvc
	Auditor Service.
SmartIF< IToolSvc >	m_ptoolSvc
	ToolSvc Service.
SmartIF< IMonitorSvc >	m_pMonitorSvc
	Online Monitoring Service.
std::string	m_monitorSvcName
	Name to use for Monitor Service.
SmartIF< ISvcLocator >	m_pSvcLocator
	Pointer to service locator service.
PropertyMgr *	m_propertyMgr
	For management of properties.
IntegerProperty	m_outputLevel
	Algorithm output level.
int	m_errorMax
	Algorithm Max number of errors.
int	m_errorCount
	Algorithm error counter.
BooleanProperty	m_auditInit
	global flag for auditors
bool	m_auditorInitialize
	flag for auditors in "initialize()"
bool	m_auditorReinitialize
	flag for auditors in "Reinitialize()"
bool	m_auditorRestart
	flag for auditors in "Restart()"
bool	m_auditorExecute
	flag for auditors in "execute()"
bool	m_auditorFinalize
	flag for auditors in "finalize()"
bool	m_auditorBeginRun
	flag for auditors in "beginRun()"
bool	m_auditorEndRun
	flag for auditors in "endRun()"
bool	m_auditorStart
	flag for auditors in "initialize()"
bool	m_auditorStop
	flag for auditors in "Reinitialize()"
bool	m_filterPassed
	Filter passed flag.
bool	m_isEnabled
	Algorithm is enabled flag.
bool	m_isExecuted
	Algorithm is executed flag.
Gaudi::StateMachine::State	m_state
	Algorithm has been initialized flag.
Gaudi::StateMachine::State	m_targetState
	Algorithm has been initialized flag.
bool	m_isFinalized
	Algorithm has been finalized flag.

---

Constructor & Destructor Documentation

Algorithm::Algorithm	(	const std::string &	name,
		ISvcLocator *	svcloc,
		const std::string &	version = PACKAGE_VERSION
	)

Constructor.

Parameters:

	name	The algorithm object's name
	svcloc	A pointer to a service location service

Definition at line 28 of file Algorithm.cpp.

  : m_name(name),
    m_version(version),
    m_pSvcLocator(pSvcLocator),
    m_filterPassed(true),
    m_isEnabled(true),
    m_isExecuted(false),
    m_state(Gaudi::StateMachine::CONFIGURED),
    m_targetState(Gaudi::StateMachine::CONFIGURED)
{
  m_propertyMgr = new PropertyMgr();
  m_subAlgms = new std::vector<Algorithm *>();

  // Declare common Algorithm properties with their defaults
  declareProperty( "OutputLevel",        m_outputLevel = MSG::NIL);
  declareProperty( "Enable",             m_isEnabled = true);
  declareProperty( "ErrorMax",           m_errorMax  = 1);
  declareProperty( "ErrorCount",         m_errorCount = 0);
  // Auditor monitoring properties

  // Get the default setting for service auditing from the AppMgr
  declareProperty( "AuditAlgorithms", m_auditInit );

  bool audit(false);
  SmartIF<IProperty> appMgr(serviceLocator()->service("ApplicationMgr"));
  if (appMgr.isValid()) {
    const Property& prop = appMgr->getProperty("AuditAlgorithms");
    Property &pr = const_cast<Property&>(prop);
    if (m_name != "IncidentSvc") {
      setProperty( pr ).ignore();
    }
    audit = m_auditInit.value();
  }

  declareProperty( "AuditInitialize"  , m_auditorInitialize   = audit ) ;
  declareProperty( "AuditReinitialize", m_auditorReinitialize = audit ) ;
  declareProperty( "AuditRestart"     , m_auditorRestart      = audit ) ;
  declareProperty( "AuditExecute"     , m_auditorExecute      = audit ) ;
  declareProperty( "AuditFinalize"    , m_auditorFinalize     = audit ) ;
  declareProperty( "AuditBeginRun"    , m_auditorBeginRun     = audit ) ;
  declareProperty( "AuditEndRun"      , m_auditorEndRun       = audit ) ;
  declareProperty( "AuditStart"       , m_auditorStart        = audit ) ;
  declareProperty( "AuditStop"        , m_auditorStop         = audit ) ;

  declareProperty( "MonitorService"   , m_monitorSvcName      = "MonitorSvc" );

  // update handlers.
  m_outputLevel.declareUpdateHandler(&Algorithm::initOutputLevel, this);

}

Algorithm::~Algorithm

(

)

[virtual]

Destructor.

Definition at line 81 of file Algorithm.cpp.

                      {
  delete m_subAlgms;
  delete m_propertyMgr;
}

Algorithm::Algorithm

(

const Algorithm &

a

)

[private]

Private Copy constructor: NO COPY ALLOWED.

---

Member Function Documentation

StatusCode Algorithm::sysStart

(

)

[virtual]

Reinitialization method invoked by the framework.

This method is responsible for any reinitialization required by the framework itself. It will in turn invoke the reinitialize() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 164 of file Algorithm.cpp.

                               {

  // Bypass the startup if already running or disabled.
  if ( Gaudi::StateMachine::RUNNING == FSMState() ||
       !isEnabled() ) return StatusCode::SUCCESS;

  m_targetState = Gaudi::StateMachine::ChangeState(Gaudi::StateMachine::START,m_state);

  // TODO: (MCl) where shoud we do this? initialize or start?
  // Reset Error count
  m_errorCount = 0;

  StatusCode sc;
  // Invoke start() method of the derived class inside a try/catch clause
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorStart) ? auditorSvc().get() : 0,
                                        IAuditor::Start);
      // Invoke the start() method of the derived class
      sc = start();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now start any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysStart();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() + ".sysInitialize()" );
      log << MSG::ERROR << " Error initializing one or several sub-algorithms"
          << endmsg;
      return result;
    }
    // Update the state.
    m_state = m_targetState;
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStart(): exception with tag=" << Exception.tag()
        << " is caught" << endmsg;
    log << MSG::ERROR << Exception << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStart(): standard std::exception is caught" << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStart(): UNKNOWN Exception is caught" << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }

  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysInitialize

(

)

[virtual]

Initialization method invoked by the framework.

This method is responsible for any bookkeeping of initialization required by the framework itself. It will in turn invoke the initialize() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 87 of file Algorithm.cpp.

                                    {

  // Bypass the initialization if the algorithm
  // has already been initialized.
  if ( Gaudi::StateMachine::INITIALIZED <= FSMState() ) return StatusCode::SUCCESS;

  // Set the Algorithm's properties
  StatusCode sc = setProperties();
  if( sc.isFailure() ) return StatusCode::FAILURE;

  // Bypass the initialization if the algorithm is disabled.
  // Need to do this after setProperties.
  if ( !isEnabled( ) ) return StatusCode::SUCCESS;

  m_targetState = Gaudi::StateMachine::ChangeState(Gaudi::StateMachine::INITIALIZE,m_state);

  // Check current outputLevel to evetually inform the MessagsSvc
  //if( m_outputLevel != MSG::NIL ) {
  setOutputLevel( m_outputLevel );
  //}

  // TODO: (MCl) where shoud we do this? initialize or start?
  // Reset Error count
  //m_errorCount = 0;

  // Invoke initialize() method of the derived class inside a try/catch clause
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorInitialize) ? auditorSvc().get() : 0,
                                        IAuditor::Initialize);
      // Invoke the initialize() method of the derived class
      sc = initialize();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now initialize care of any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysInitialize();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() + ".sysInitialize()" );
      log << MSG::ERROR << " Error initializing one or several sub-algorithms"
          << endmsg;
      return result;
    }
    // Update the state.
    m_state = m_targetState;
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() + ".sysInitialize()" );
    log << MSG::FATAL << " Exception with tag=" << Exception.tag()
        << " is caught " << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() + ".sysInitialize()" );
    log << MSG::FATAL << " Standard std::exception is caught " << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() + ".sysInitialize()" );
    log << MSG::FATAL << "UNKNOWN Exception is caught " << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }

  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysReinitialize

(

)

[virtual]

Reinitialization method invoked by the framework.

This method is responsible for any reinitialization required by the framework itself. It will in turn invoke the reinitialize() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 229 of file Algorithm.cpp.

                                      {

  // Bypass the initialization if the algorithm is disabled.
  if ( !isEnabled( ) ) return StatusCode::SUCCESS;

  // Check that the current status is the correct one.
  if ( Gaudi::StateMachine::INITIALIZED != FSMState() ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR
        << "sysReinitialize(): cannot reinitialize algorithm not initialized"
        << endmsg;
    return StatusCode::FAILURE;
  }

  // Check current outputLevel to evetually inform the MessagsSvc
  //if( m_outputLevel != MSG::NIL ) {
  setOutputLevel( m_outputLevel );
  //}

  // Reset Error count
  // m_errorCount = 0; // done during start

  StatusCode sc(StatusCode::SUCCESS,true);
  // Invoke reinitialize() method of the derived class inside a try/catch clause
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorReinitialize) ? auditorSvc().get() : 0,
                                        IAuditor::ReInitialize);
      // Invoke the reinitialize() method of the derived class
      sc = reinitialize();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now initialize care of any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysReinitialize();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() );
      log << MSG::ERROR
          << "sysReinitialize(): Error reinitializing one or several sub-algorithms"
          << endmsg;
      return result;
    }
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysReinitialize(): Exception with tag=" << Exception.tag()
        << " is caught" << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysReinitialize(): Standard std::exception is caught" << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysReinitialize(): UNKNOWN Exception is caught" << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }

  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysRestart

(

)

[virtual]

Restart method invoked by the framework.

It will in turn invoke the restart() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 303 of file Algorithm.cpp.

                                 {

  // Bypass the initialization if the algorithm is disabled.
  if ( !isEnabled( ) ) return StatusCode::SUCCESS;

  // Check that the current status is the correct one.
  if ( Gaudi::StateMachine::RUNNING != FSMState() ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR
        << "sysRestart(): cannot restart algorithm not started"
        << endmsg;
    return StatusCode::FAILURE;
  }

  // Check current outputLevel to evetually inform the MessagsSvc
  //if( m_outputLevel != MSG::NIL ) {
  setOutputLevel( m_outputLevel );
  //}

  // Reset Error count
  m_errorCount = 0;

  StatusCode sc(StatusCode::SUCCESS,true);
  // Invoke reinitialize() method of the derived class inside a try/catch clause
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorRestart) ? auditorSvc().get() : 0,
                                        IAuditor::ReStart);
      // Invoke the reinitialize() method of the derived class
      sc = restart();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now initialize care of any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysRestart();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() );
      log << MSG::ERROR
          << "sysRestart(): Error restarting one or several sub-algorithms"
          << endmsg;
      return result;
    }
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysRestart(): Exception with tag=" << Exception.tag()
        << " is caught" << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysRestart(): Standard std::exception is caught" << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "sysRestart(): UNKNOWN Exception is caught" << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }

  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysExecute

(

)

[virtual]

The actions to be performed by the algorithm on an event.

This method is invoked once per event for top level algorithms by the application manager. This method invokes execute() method. For sub-algorithms either the sysExecute() method or execute() method must be EXPLICITLY invoked by the parent algorithm.

Reimplemented in GaudiAlgorithm.

Definition at line 511 of file Algorithm.cpp.

                                 {
  if (!isEnabled()) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::VERBOSE << ".sysExecute(): is not enabled. Skip execution" <<endmsg;
    return StatusCode::SUCCESS;
  }

  StatusCode status;

  // Should performance profile be performed ?
  // invoke execute() method of Algorithm class
  //   and catch all uncaught exceptions

  Gaudi::Guards::AuditorGuard guard(this,
                                    // check if we want to audit the initialize
                                    (m_auditorExecute) ? auditorSvc().get() : 0,
                                    IAuditor::Execute,
                                    status);
  try {
    status = execute();
    setExecuted(true);  // set the executed flag

    if (status.isFailure()) {
      status = exceptionSvc()->handleErr(*this,status);
    }

  }
  catch( const GaudiException& Exception ) {
    setExecuted(true);  // set the executed flag

    MsgStream log ( msgSvc() , name() + ".sysExecute()" );
    if (Exception.code() == StatusCode::FAILURE) {
      log << MSG::FATAL;
    } else {
      log << MSG::ERROR << " Recoverable";
    }

    log << " Exception with tag=" << Exception.tag()
        << " is caught " << endmsg;

    log << MSG::ERROR << Exception  << endmsg;

    Stat stat( chronoSvc() , Exception.tag() ) ;
    status = exceptionSvc()->handle(*this,Exception);
  }
  catch( const std::exception& Exception ) {
    setExecuted(true);  // set the executed flag

    MsgStream log ( msgSvc() , name() + ".sysExecute()" );
    log << MSG::FATAL << " Standard std::exception is caught " << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" ) ;
    status = exceptionSvc()->handle(*this,Exception);
  }
  catch(...) {
    setExecuted(true);  // set the executed flag

    MsgStream log ( msgSvc() , name() + ".sysExecute()" );
    log << MSG::FATAL << "UNKNOWN Exception is caught " << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;

    status = exceptionSvc()->handle(*this);
  }

  if( status.isFailure() ) {
    MsgStream log ( msgSvc() , name() );
    // Increment the error count
    m_errorCount++;
    // Check if maximum is exeeded
    if( m_errorCount < m_errorMax ) {
      log << MSG::WARNING << "Continuing from error (cnt=" << m_errorCount
          << ", max=" << m_errorMax << ")" << endmsg;
      // convert to success
      status = StatusCode::SUCCESS;
    }
  }
  return status;
}

StatusCode Algorithm::sysStop

(

)

[virtual]

System stop.

This method invokes the stop() method of a concrete algorithm and the stop() methods of all of that algorithm's sub algorithms.

Definition at line 591 of file Algorithm.cpp.

                              {

  // Bypass the startup if already running or disabled.
  if ( Gaudi::StateMachine::INITIALIZED == FSMState() ||
       !isEnabled() ) return StatusCode::SUCCESS;

  m_targetState = Gaudi::StateMachine::ChangeState(Gaudi::StateMachine::STOP,m_state);

  StatusCode sc;
  // Invoke stop() method of the derived class inside a try/catch clause
  try {
    // Stop first any sub-algorithms (in reverse order)
    std::vector<Algorithm *>::reverse_iterator it;
    for (it = m_subAlgms->rbegin(); it != m_subAlgms->rend(); it++) {
      (*it)->sysStop().ignore();
    }
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorStop) ? auditorSvc().get() : 0,
                                        IAuditor::Stop);

      // Invoke the stop() method of the derived class
      sc = stop();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Update the state.
    m_state = m_targetState;
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStop(): exception with tag=" << Exception.tag()
        << " is caught" << endmsg;
    log << MSG::ERROR << Exception << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStop(): standard std::exception is caught" << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::FATAL << "in sysStop(): UNKNOWN Exception is caught" << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }

  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysFinalize

(

)

[virtual]

System finalization.

This method invokes the finalize() method of a concrete algorithm and the finalize() methods of all of that algorithm's sub algorithms.

Definition at line 644 of file Algorithm.cpp.

                                  {

  // Bypass the finalialization if the algorithm hasn't been initilized.
  if ( Gaudi::StateMachine::CONFIGURED == FSMState() ||
       !isEnabled() ) return StatusCode::SUCCESS;

  m_targetState = Gaudi::StateMachine::ChangeState(Gaudi::StateMachine::FINALIZE,m_state);

  // Invoke finalize() method of the derived class inside a try/catch clause
  StatusCode sc = StatusCode::SUCCESS;
  try {
    // Order changed (bug #3903 overview: finalize and nested algorithms)
    // Finalize first any sub-algoithms (it can be done more than once)
    std::vector<Algorithm *>::iterator it;
    bool fail(false);
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      if (!(*it)->sysFinalize().isSuccess()) {
        fail = true;
      }
    }

    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorFinalize) ? auditorSvc().get() : 0,
                                        IAuditor::Finalize);
      // Invoke the finalize() method of the derived class
      sc = finalize();
    }
    if( !sc.isSuccess() || fail )  return StatusCode::FAILURE;

    // Release all sub-algorithms
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      (*it)->release();
    }
    // Indicate that this Algorithm has been finalized to prevent duplicate attempts
    m_state = m_targetState;
    return sc;
  }
  catch( const GaudiException& Exception ) {
    MsgStream log ( msgSvc() , name() + ".sysFinalize()" );
    log << MSG::FATAL << " Exception with tag=" << Exception.tag()
        << " is caught " << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() ) ;
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() + ".sysFinalize()" );
    log << MSG::FATAL << " Standard std::exception is caught " << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" ) ;
  }
  catch( ... ) {
    MsgStream log ( msgSvc() , name() + ".sysFinalize()" );
    log << MSG::FATAL << "UNKNOWN Exception is caught " << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }
  return StatusCode::FAILURE ;
}

StatusCode Algorithm::sysBeginRun

(

)

[virtual]

beginRun method invoked by the framework.

This method is responsible for any beginRun actions required by the framework itself. It will in turn invoke the beginRun() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 377 of file Algorithm.cpp.

                                  {

  // Bypass the beginRun if the algorithm is disabled.
  if ( !isEnabled( ) ) return StatusCode::SUCCESS;

  // Check current outputLevel to evetually inform the MessagsSvc
  //if( m_outputLevel != MSG::NIL ) {
  setOutputLevel( m_outputLevel );
  //}

  // Reset Error count
  m_errorCount = 0;

  StatusCode sc;
  // Invoke beginRun() method of the derived class inside a try/catch clause
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorBeginRun) ? auditorSvc().get() : 0,
                                        IAuditor::BeginRun);
      // Invoke the beginRun() method of the derived class
      sc = beginRun();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now call beginRun for any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysBeginRun();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() + ".sysBeginRun()" );
      log << MSG::ERROR << " Error executing BeginRun for one or several sub-algorithms"
          << endmsg;
      return result;
    }
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() + ".sysBeginRun()" );
    log << MSG::FATAL << " Exception with tag=" << Exception.tag()
        << " is caught " << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() + ".sysBeginRun()" );
    log << MSG::FATAL << " Standard std::exception is caught " << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() + ".sysBeginRun()" );
    log << MSG::FATAL << "UNKNOWN Exception is caught " << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }
  return StatusCode::FAILURE;
}

StatusCode Algorithm::sysEndRun

(

)

[virtual]

endRun method invoked by the framework.

This method is responsible for any endRun actions required by the framework itself. It will in turn invoke the endRun() method of the derived algorithm, and of any sub-algorithms which it creates.

Definition at line 444 of file Algorithm.cpp.

                                {

  // Bypass the endRun if the algorithm is disabled.
  if ( !isEnabled( ) ) return StatusCode::SUCCESS;

  // Check current outputLevel to eventually inform the MessagsSvc
  //if( m_outputLevel != MSG::NIL ) {
  setOutputLevel( m_outputLevel );
  //}

  // Reset Error count
  m_errorCount = 0;

  // Invoke endRun() method of the derived class inside a try/catch clause
  StatusCode sc;
  try {
    { // limit the scope of the guard
      Gaudi::Guards::AuditorGuard guard(this,
                                        // check if we want to audit the initialize
                                        (m_auditorEndRun) ? auditorSvc().get() : 0,
                                        IAuditor::EndRun);
      // Invoke the endRun() method of the derived class
      sc = endRun();
    }
    if( sc.isFailure() ) return StatusCode::FAILURE;

    // Now call endRun for any sub-algorithms
    std::vector<Algorithm *>::iterator it;
    StatusCode result = StatusCode::SUCCESS;
    for (it = m_subAlgms->begin(); it != m_subAlgms->end(); it++) {
      sc = (*it)->sysEndRun();
      if( sc.isFailure() ) result = sc;
    }
    if( result.isFailure() ) {
      MsgStream log ( msgSvc() , name() + ".sysEndRun()" );
      log << MSG::ERROR << " Error calling endRun for one or several sub-algorithms"
          << endmsg;
      return result;
    }
    return StatusCode::SUCCESS;
  }
  catch ( const GaudiException& Exception )  {
    MsgStream log ( msgSvc() , name() + ".sysEndRun()" );
    log << MSG::FATAL << " Exception with tag=" << Exception.tag()
        << " is caught " << endmsg;
    log << MSG::ERROR << Exception  << endmsg;
    Stat stat( chronoSvc() , Exception.tag() );
  }
  catch( const std::exception& Exception ) {
    MsgStream log ( msgSvc() , name() + ".sysEndRun()" );
    log << MSG::FATAL << " Standard std::exception is caught " << endmsg;
    log << MSG::ERROR << Exception.what()  << endmsg;
    Stat stat( chronoSvc() , "*std::exception*" );
  }
  catch(...) {
    MsgStream log ( msgSvc() , name() + ".sysEndRun()" );
    log << MSG::FATAL << "UNKNOWN Exception is caught " << endmsg;
    Stat stat( chronoSvc() , "*UNKNOWN Exception*" ) ;
  }
  return StatusCode::FAILURE;
}

const std::string & Algorithm::name

(

)

const [virtual]

The identifying name of the algorithm object.

This is the name of a particular instantiation of an algorithm object as opposed to the name of the algorithm itself, e.g. "LinearTrackFit" may be the name of a concrete algorithm class, whereas "ApproxTrackFit" and "BestTrackFit" may be two instantiations of the class configured to find tracks with different fit criteria.

Definition at line 743 of file Algorithm.cpp.

                                       {
  return m_name;
}

const std::string & Algorithm::version

(

)

const [virtual]

Definition at line 747 of file Algorithm.cpp.

                                          {
  return m_version;
}

virtual StatusCode Algorithm::configure

(

)

[inline, virtual]

Dummy implementation of IStateful::configure() method.

Definition at line 147 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

virtual StatusCode Algorithm::terminate

(

)

[inline, virtual]

Dummy implementation of IStateful::terminate() method.

Definition at line 149 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

virtual StatusCode Algorithm::initialize

(

)

[inline, virtual]

the default (empty) implementation of IStateful::initialize() method

Reimplemented in EventCounter, GaudiAlgorithm, GaudiHistoAlg, GaudiSequencer, GaudiTupleAlg, Prescaler, Sequencer, GaudiPython::PyAlgorithm, PartitionSwitchAlg, StoreExplorerAlg, CollectionCloneAlg, EvtCollectionStream, OutputStream, TagCollectionStream, GaudiCommon< Algorithm >, GaudiHistos< GaudiAlgorithm >, and GaudiTuples< GaudiHistoAlg >.

Definition at line 152 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

virtual StatusCode Algorithm::start

(

)

[inline, virtual]

the default (empty) implementation of IStateful::start() method

Reimplemented in Sequencer, and GaudiPython::PyAlgorithm.

Definition at line 154 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

virtual StatusCode Algorithm::stop

(

)

[inline, virtual]

the default (empty) implementation of IStateful::stop() method

Reimplemented in Sequencer, and GaudiPython::PyAlgorithm.

Definition at line 156 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

virtual StatusCode Algorithm::finalize

(

void

)

[inline, virtual]

the default (empty) implementation of IStateful::finalize() method

Reimplemented in EventCounter, GaudiAlgorithm, GaudiHistoAlg, GaudiSequencer, GaudiTupleAlg, Prescaler, Sequencer, GaudiPython::PyAlgorithm, PartitionSwitchAlg, StoreExplorerAlg, CollectionCloneAlg, EvtCollectionStream, OutputStream, RecordStream, RunRecordStream, TagCollectionStream, GaudiCommon< Algorithm >, GaudiHistos< GaudiAlgorithm >, and GaudiTuples< GaudiHistoAlg >.

Definition at line 158 of file Algorithm.h.

{ return StatusCode::SUCCESS ; }

StatusCode Algorithm::reinitialize

(

)

[virtual]

the default (empty) implementation of IStateful::reinitialize() method

Reimplemented in Sequencer.

Definition at line 704 of file Algorithm.cpp.

                                   {
  /* @TODO
   * MCl 2008-10-23: the implementation of reinitialize as finalize+initialize
   *                 is causing too many problems
   *
  // Default implementation is finalize+initialize
  StatusCode sc = finalize();
  if (sc.isFailure()) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR << "reinitialize(): cannot be finalized" << endmsg;
    return sc;
  }
  sc = initialize();
  if (sc.isFailure()) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR << "reinitialize(): cannot be initialized" << endmsg;
    return sc;
  }
  */
  return StatusCode::SUCCESS;
}

StatusCode Algorithm::restart

(

)

[virtual]

the default (empty) implementation of IStateful::restart() method

Definition at line 726 of file Algorithm.cpp.

                              {
  // Default implementation is stop+start
  StatusCode sc = stop();
  if (sc.isFailure()) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR << "restart(): cannot be stopped" << endmsg;
    return sc;
  }
  sc = start();
  if (sc.isFailure()) {
    MsgStream log ( msgSvc() , name() );
    log << MSG::ERROR << "restart(): cannot be started" << endmsg;
    return sc;
  }
  return StatusCode::SUCCESS;
}

bool Algorithm::isExecuted

(

)

const [virtual]

Has this algorithm been executed since the last reset?

Definition at line 751 of file Algorithm.cpp.

                                 {
  return m_isExecuted;
}

void Algorithm::setExecuted

(

bool

state

)

[virtual]

Set the executed flag to the specified state.

Definition at line 755 of file Algorithm.cpp.

                                        {
  m_isExecuted = state;
}

void Algorithm::resetExecuted

(

)

[virtual]

Reset the executed state of the Algorithm for the duration of the current event.

Reimplemented in GaudiSequencer, and Sequencer.

Definition at line 759 of file Algorithm.cpp.

                              {
  m_isExecuted   = false;
  m_filterPassed = true;
}

StatusCode Algorithm::beginRun

(

)

[virtual]

Algorithm begin run.

This method is called at the beginning of the event loop.

Reimplemented in GaudiSequencer, Sequencer, and GaudiPython::PyAlgorithm.

Definition at line 439 of file Algorithm.cpp.

                               {
  return StatusCode::SUCCESS;
}

StatusCode Algorithm::endRun

(

)

[virtual]

Algorithm end run. This method is called at the end of the event loop.

Reimplemented in GaudiSequencer, Sequencer, and GaudiPython::PyAlgorithm.

Definition at line 506 of file Algorithm.cpp.

                             {
  return StatusCode::SUCCESS;
}

virtual Gaudi::StateMachine::State Algorithm::FSMState

(

)

const [inline, virtual]

returns the current state of the algorithm

Definition at line 185 of file Algorithm.h.

{ return m_state; }

virtual Gaudi::StateMachine::State Algorithm::targetFSMState

(

)

const [inline, virtual]

returns the state the algorithm will be in after the ongoing transition

Definition at line 188 of file Algorithm.h.

{ return m_targetState; }

bool Algorithm::isEnabled

(

)

const [virtual]

Is this algorithm enabled or disabled?

Definition at line 764 of file Algorithm.cpp.

                                {
  return m_isEnabled;
}

bool Algorithm::filterPassed

(

)

const [virtual]

Did this algorithm pass or fail its filter criterion for the last event?

Definition at line 768 of file Algorithm.cpp.

                                   {
  return m_filterPassed;
}

void Algorithm::setFilterPassed

(

bool

state

)

[virtual]

Set the filter passed flag to the specified state.

Definition at line 772 of file Algorithm.cpp.

                                            {
  m_filterPassed = state;
}

template<class T>

StatusCode Algorithm::service	(	const std::string &	name,
		T *&	psvc,
		bool	createIf = true
	)			const [inline]

Access a service by name, creating it if it doesn't already exist.

Definition at line 202 of file Algorithm.h.

                                                                  {
    return service_i(name, createIf, T::interfaceID(), (void**)&psvc);
  }

template<class T>

StatusCode Algorithm::service	(	const std::string &	svcType,
		const std::string &	svcName,
		T *&	psvc
	)			const [inline]

Access a service by name and type, creating it if it doesn't already exist.

Definition at line 208 of file Algorithm.h.

                                      {
    return service_i(svcType, svcName, T::interfaceID(), (void**)&psvc);
  }

SmartIF< IService > Algorithm::service	(	const std::string &	name,
		const bool	createIf = true,
		const bool	quiet = false
	)			const

Return a pointer to the service identified by name (or "type/name").

Definition at line 1094 of file Algorithm.cpp.

                                                                                                       {
  const ServiceLocatorHelper helper(*serviceLocator(), *this);
  return helper.service(name, quiet, createIf);
}

void Algorithm::setOutputLevel

(

int

level

)

Set the output level for current algorithm.

Definition at line 780 of file Algorithm.cpp.

                                          {
  if ( msgSvc() != 0 )
  {
    if ( MSG::NIL != level )
    { msgSvc()->setOutputLevel( name(), level ) ; }
    m_outputLevel = msgSvc()->outputLevel( name() );
  }
}

SmartIF<IAuditorSvc>& Algorithm::auditorSvc

(

)

const

The standard auditor service.May not be invoked before sysInitialize() has been invoked.

SmartIF<IChronoStatSvc>& Algorithm::chronoSvc

(

)

const

The standard Chrono & Stat service, Return a pointer to the service if present.

SmartIF<IChronoStatSvc>& Algorithm::chronoStatService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

SmartIF<IDataProviderSvc>& Algorithm::detSvc

(

)

const

The standard detector data service.

May not be invoked before sysInitialize() has been invoked.

SmartIF< IDataProviderSvc > & Algorithm::detDataService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 831 of file Algorithm.cpp.

                                                           {
  return detSvc();
}

SmartIF<IConversionSvc>& Algorithm::detCnvSvc

(

)

const

The standard detector data persistency conversion service.

May not be invoked before sysInitialize() has been invoked.

SmartIF< IConversionSvc > & Algorithm::detDataCnvService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 835 of file Algorithm.cpp.

                                                            {
  return detCnvSvc();
}

SmartIF<IDataProviderSvc>& Algorithm::eventSvc

(

)

const

The standard event data service.

May not be invoked before sysInitialize() has been invoked.

SmartIF<IDataProviderSvc>& Algorithm::evtSvc

(

)

const [inline]

shortcut for method eventSvc

Definition at line 252 of file Algorithm.h.

{ return eventSvc() ; }

SmartIF< IDataProviderSvc > & Algorithm::eventDataService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 839 of file Algorithm.cpp.

                                                             {
  return eventSvc();
}

SmartIF<IConversionSvc>& Algorithm::eventCnvSvc

(

)

const

The standard event data persistency conversion service.

May not be invoked before sysInitialize() has been invoked.

SmartIF< IConversionSvc > & Algorithm::eventDataCnvService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 843 of file Algorithm.cpp.

                                                              {
  return eventCnvSvc();
}

SmartIF<IHistogramSvc>& Algorithm::histoSvc

(

)

const

The standard histogram service.

May not be invoked before sysInitialize() has been invoked.

SmartIF< IHistogramSvc > & Algorithm::histogramDataService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 847 of file Algorithm.cpp.

                                                              {
  return histoSvc();
}

SmartIF< IMessageSvc > & Algorithm::msgSvc

(

)

const

The standard message service.

Returns a pointer to the standard message service. May not be invoked before sysInitialize() has been invoked.

Definition at line 802 of file Algorithm.cpp.

                                              {
  if ( !m_MS.isValid() ) {
    //can not use service() method (infinite recursion!)
    m_MS = serviceLocator(); // default message service
    if( !m_MS.isValid() ) {
      throw GaudiException("Service [MessageSvc] not found", name(), StatusCode::FAILURE);
    }
  }
  return m_MS;
}

SmartIF< IMessageSvc > & Algorithm::messageService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 851 of file Algorithm.cpp.

                                                      {
  return msgSvc();
}

SmartIF<INTupleSvc>& Algorithm::ntupleSvc

(

)

const

The standard N tuple service.

Returns a pointer to the N tuple service if present.

SmartIF< INTupleSvc > & Algorithm::ntupleService

(

)

const

Obsoleted name, kept due to the backwards compatibility.

Definition at line 855 of file Algorithm.cpp.

                                                    {
  return ntupleSvc();
}

SmartIF<IRndmGenSvc>& Algorithm::randSvc

(

)

const

AIDA-based NTuple service Returns a pointer to the AIDATuple service if present.

The standard RandomGen service, Return a pointer to the service if present

SmartIF<IToolSvc>& Algorithm::toolSvc

(

)

const

The standard ToolSvc service, Return a pointer to the service if present.

SmartIF<IExceptionSvc>& Algorithm::exceptionSvc

(

)

const

Get the exception Service.

SmartIF< ISvcLocator > & Algorithm::serviceLocator

(

)

const

The standard service locator.

Returns a pointer to the service locator service. This service may be used by an algorithm to request any services it requires in addition to those provided by default.

Definition at line 995 of file Algorithm.cpp.

                                                      {
  return *const_cast<SmartIF<ISvcLocator>*>(&m_pSvcLocator);
}

SmartIF<ISvcLocator>& Algorithm::svcLoc

(

)

const [inline]

shortcut for method serviceLocator

Definition at line 311 of file Algorithm.h.

{ return serviceLocator() ; }

StatusCode Algorithm::createSubAlgorithm	(	const std::string &	type,
		const std::string &	name,
		Algorithm *&	pSubAlg
	)

Create a sub algorithm.

A call to this method creates a child algorithm object. Note that the returned pointer is to Algorithm (as opposed to IAlgorithm), and thus the methods of IProperty are also available for the direct setting of the sub-algorithm's properties. Using this mechanism instead of creating daughter algorithms directly via the new operator is prefered since then the framework may take care of all of the necessary book-keeping.

Parameters:

	type	The concrete algorithm class of the sub algorithm
	name	The name to be given to the sub algorithm
	pSubAlg	Set to point to the newly created algorithm object

Definition at line 1020 of file Algorithm.cpp.

                                                                    {
  if( m_pSvcLocator == 0 ) return StatusCode::FAILURE;

  SmartIF<IAlgManager> am(m_pSvcLocator);
  if ( !am.isValid() ) return StatusCode::FAILURE;

  // Maybe modify the AppMgr interface to return Algorithm* ??
  IAlgorithm *tmp;
  StatusCode sc = am->createAlgorithm
    (type, name+getGaudiThreadIDfromName(Algorithm::name()), tmp);
  if( sc.isFailure() ) return StatusCode::FAILURE;

  try{
    pSubAlgorithm = dynamic_cast<Algorithm*>(tmp);
    m_subAlgms->push_back(pSubAlgorithm);
  } catch(...){
    sc = StatusCode::FAILURE;
  }
  return sc;
}

std::vector< Algorithm * > * Algorithm::subAlgorithms

(

)

const

List of sub-algorithms. Returns a pointer to a vector of (sub) Algorithms.

Definition at line 776 of file Algorithm.cpp.

                                                       {
  return m_subAlgms;
}

StatusCode Algorithm::setProperty

(

const Property &

p

)

[virtual]

Implementation of IProperty::setProperty.

Definition at line 1045 of file Algorithm.cpp.

                                                   {
  return m_propertyMgr->setProperty(p);
}

StatusCode Algorithm::setProperty

(

const std::string &

s

)

[virtual]

Implementation of IProperty::setProperty.

Definition at line 1048 of file Algorithm.cpp.

                                                    {
  return m_propertyMgr->setProperty(s);
}

StatusCode Algorithm::setProperty	(	const std::string &	n,
		const std::string &	v
	)			[virtual]

Implementation of IProperty::setProperty.

Definition at line 1051 of file Algorithm.cpp.

                                                                        {
  return m_propertyMgr->setProperty(n,v);
}

StatusCode Algorithm::getProperty

(

Property *

p

)

const [virtual]

Implementation of IProperty::getProperty.

Definition at line 1054 of file Algorithm.cpp.

                                                   {
  return m_propertyMgr->getProperty(p);
}

const Property & Algorithm::getProperty

(

const std::string &

name

)

const [virtual]

Implementation of IProperty::getProperty.

Definition at line 1057 of file Algorithm.cpp.

                                                                  {
  return m_propertyMgr->getProperty(name);
}

StatusCode Algorithm::getProperty	(	const std::string &	n,
		std::string &	v
	)			const [virtual]

Implementation of IProperty::getProperty.

Definition at line 1060 of file Algorithm.cpp.

                                                                         {
  return m_propertyMgr->getProperty(n,v);
}

const std::vector< Property * > & Algorithm::getProperties

(

)

const [virtual]

Implementation of IProperty::getProperties.

Definition at line 1063 of file Algorithm.cpp.

                                                            {
  return m_propertyMgr->getProperties();
}

StatusCode Algorithm::setProperties

(

)

Set the algorithm's properties.

This method requests the job options service to set the values of any declared properties. The method is invoked from within sysInitialize() by the framework and does not need to be explicitly called by a concrete algorithm.

Definition at line 1000 of file Algorithm.cpp.

                                    {
  if( m_pSvcLocator != 0 )    {
    SmartIF<IJobOptionsSvc> jos(m_pSvcLocator->service("JobOptionsSvc"));
    if( jos.isValid() ) {
      // set first generic Properties
      StatusCode sc = jos->setMyProperties( getGaudiThreadGenericName(name()), this );
      if( sc.isFailure() ) return StatusCode::FAILURE;

      // set specific Properties
      if (isGaudiThreaded(name())) {
        if(jos->setMyProperties( name(), this ).isFailure()) {
          return StatusCode::FAILURE;
        }
      }
      return sc;
    }
  }
  return StatusCode::FAILURE;
}

template<class T>

Property* Algorithm::declareProperty	(	const std::string &	name,
		T &	property,
		const std::string &	doc = "none"
	)			const [inline]

Declare the named property.

  MyAlg ( const std::string& name ,
          ISvcLocator*       pSvc )
     : Algorithm ( name , pSvc )
     , m_property1   ( ... )
     , m_property2   ( ... )
   {
     // declare the property
     declareProperty( "Property1" , m_property1 , "Doc fro property #1" ) ;

     // declare the property and attach the handler  to it
     declareProperty( "Property2" , m_property2 , "Doc for property #2" )
        -> declareUpdateHandler( &MyAlg::handler_2 ) ;

   }

See also:

PropertyMgr

PropertyMgr::declareProperty

Parameters:

	name	the property name
	property	the property itself,
	doc	the documentation string

Returns:

the actual property objects

Definition at line 386 of file Algorithm.h.

  {
    return m_propertyMgr->declareProperty(name, property, doc);
  }

Property* Algorithm::declareRemoteProperty	(	const std::string &	name,
		IProperty *	rsvc,
		const std::string &	rname = ""
	)			const [inline]

Declare remote named properties.

Definition at line 395 of file Algorithm.h.

  {
    return m_propertyMgr -> declareRemoteProperty ( name , rsvc , rname );
  }

SmartIF<IMonitorSvc>& Algorithm::monitorSvc

(

)

const [inline]

Access the monitor service.

Attention:

Note that this method will return a NULL pointer if no monitor service is configured to be present. You must take this possibility into account when using the pointer

Returns:

Pointer to the Monitor service

Return values:

	NULL	No monitor service is present
	non-NULL	A monitor service is present and available to be used

Definition at line 411 of file Algorithm.h.

  {
    // If not already located try to locate it without forcing a creation
    if ( !m_pMonitorSvc.isValid() ){
      m_pMonitorSvc = service(m_monitorSvcName, false, true); // do not create and be quiet
    }
    return m_pMonitorSvc;
  }

template<class T>

void Algorithm::declareInfo	(	const std::string &	name,
		const T &	var,
		const std::string &	desc
	)			const [inline]

Declare monitoring information.

Parameters:

	name	Monitoring information name known to the external system
	var	Monitoring Listener address (the item to monitor...)
	desc	Textual description of the information being monitored

Definition at line 426 of file Algorithm.h.

  {
    IMonitorSvc* mS = monitorSvc().get();
    if ( mS ) mS->declareInfo(name, var, desc, this);
  }

void Algorithm::declareInfo	(	const std::string &	name,
		const std::string &	format,
		const void *	var,
		int	size,
		const std::string &	desc
	)			const [inline]

Declare monitoring information (special case).

Parameters:

	name	Monitoring information name known to the external system
	format	Format information
	var	Monitoring Listener address
	size	Monitoring Listener address size
	desc	Textual description of the information being monitored

Definition at line 441 of file Algorithm.h.

  {
    IMonitorSvc* mS = monitorSvc().get();
    if ( mS ) mS->declareInfo(name, format, var, size, desc, this);
  }

template<class TYPE>

StatusCode Algorithm::setProperty	(	const std::string &	name,
		const TYPE &	value
	)			[inline]

set the property form the value

  std::vector<double> data = ... ;

  setProperty( "Data" , data ) ;

  std::map<std::string,double> cuts = ... ;
  setProperty( "Cuts" , cuts ) ;

  std::map<std::string,std::string> dict = ... ;
  setProperty( "Dictionary" , dict ) ;

Note: the interface IProperty allows setting of the properties either directly from other properties or from strings only

This is very convenient in resetting of the default properties in the derived classes. E.g. without this method one needs to convert everything into strings to use IProperty::setProperty

    setProperty ( "OutputLevel" , "1"    ) ;
    setProperty ( "Enable"      , "True" ) ;
    setProperty ( "ErrorMax"    , "10"   ) ;

For simple cases it is more or less ok, but for complicated properties it is just ugly..

Parameters:

	name	name of the property
	value	value of the property

See also:

Gaudi::Utils::setProperty

Author:

Vanya BELYAEV ibelyaev@physics.syr.edu

Date:

2007-05-13

Definition at line 497 of file Algorithm.h.

  { return Gaudi::Utils::setProperty ( m_propertyMgr , name , value ) ; }

bool Algorithm::isInitialized

(

)

const [inline, protected]

Has the Algorithm already been initialized?

Definition at line 504 of file Algorithm.h.

{ return Gaudi::StateMachine::INITIALIZED == m_state; }

bool Algorithm::isFinalized

(

)

const [inline, protected]

Has the Algorithm already been finalized?

Definition at line 507 of file Algorithm.h.

{ return Gaudi::StateMachine::CONFIGURED == m_state; }

int Algorithm::outputLevel

(

)

const [inline, protected]

retrieve the Algorithm output level

Definition at line 510 of file Algorithm.h.

{ return (int)m_outputLevel ; }

IntegerProperty& Algorithm::outputLevelProperty

(

)

[inline, protected]

Accessor for the Message level property.

Definition at line 513 of file Algorithm.h.

{ return m_outputLevel; }

void Algorithm::initOutputLevel

(

Property &

prop

)

[protected]

callback for output level property

Protected Member Functions.

Definition at line 1071 of file Algorithm.cpp.

{
  // do nothing... yet ?
}

StatusCode Algorithm::service_i	(	const std::string &	svcName,
		bool	createIf,
		const InterfaceID &	iid,
		void **	ppSvc
	)			const [private]

implementation of service method

Definition at line 1077 of file Algorithm.cpp.

                                         {
  const ServiceLocatorHelper helper(*serviceLocator(), *this);
  return helper.getService(svcName, createIf, iid, ppSvc);
}

StatusCode Algorithm::service_i	(	const std::string &	svcType,
		const std::string &	svcName,
		const InterfaceID &	iid,
		void **	ppSvc
	)			const [private]

Definition at line 1086 of file Algorithm.cpp.

                                         {
  const ServiceLocatorHelper helper(*serviceLocator(), *this);
  return helper.createService(svcType, svcName, iid, ppSvc);
}

Algorithm& Algorithm::operator=

(

const Algorithm &

rhs

)

[private]

Private assignment operator: NO ASSIGNMENT ALLOWED.

---

Member Data Documentation

std::string Algorithm::m_name [private]

Algorithm's name for identification.

Definition at line 521 of file Algorithm.h.

std::string Algorithm::m_version [private]

Algorithm's version.

Definition at line 522 of file Algorithm.h.

std::vector<Algorithm *>* Algorithm::m_subAlgms [private]

Sub algorithms.

Definition at line 523 of file Algorithm.h.

SmartIF<IMessageSvc> Algorithm::m_MS [mutable, private]

Message service.

Definition at line 525 of file Algorithm.h.

SmartIF<IDataProviderSvc> Algorithm::m_EDS [mutable, private]

Event data service.

Definition at line 526 of file Algorithm.h.

SmartIF<IConversionSvc> Algorithm::m_ECS [mutable, private]

Event conversion service.

Definition at line 527 of file Algorithm.h.

SmartIF<IDataProviderSvc> Algorithm::m_DDS [mutable, private]

Detector data service.

Definition at line 528 of file Algorithm.h.

SmartIF<IConversionSvc> Algorithm::m_DCS [mutable, private]

Detector conversion service.

Definition at line 529 of file Algorithm.h.

SmartIF<IHistogramSvc> Algorithm::m_HDS [mutable, private]

Histogram data service.

Definition at line 530 of file Algorithm.h.

SmartIF<INTupleSvc> Algorithm::m_NTS [mutable, private]

N tuple service.

Definition at line 531 of file Algorithm.h.

SmartIF<IChronoStatSvc> Algorithm::m_CSS [mutable, private]

Chrono & Stat Service.

Definition at line 533 of file Algorithm.h.

SmartIF<IRndmGenSvc> Algorithm::m_RGS [mutable, private]

Random Number Generator Service.

Definition at line 534 of file Algorithm.h.

SmartIF<IExceptionSvc> Algorithm::m_EXS [mutable, private]

Exception Handler Service.

Definition at line 535 of file Algorithm.h.

SmartIF<IAuditorSvc> Algorithm::m_pAuditorSvc [mutable, private]

Auditor Service.

Definition at line 536 of file Algorithm.h.

SmartIF<IToolSvc> Algorithm::m_ptoolSvc [mutable, private]

ToolSvc Service.

Definition at line 537 of file Algorithm.h.

SmartIF<IMonitorSvc> Algorithm::m_pMonitorSvc [mutable, private]

Online Monitoring Service.

Definition at line 538 of file Algorithm.h.

std::string Algorithm::m_monitorSvcName [private]

Name to use for Monitor Service.

Definition at line 539 of file Algorithm.h.

SmartIF<ISvcLocator> Algorithm::m_pSvcLocator [private]

Pointer to service locator service.

Definition at line 540 of file Algorithm.h.

PropertyMgr* Algorithm::m_propertyMgr [private]

For management of properties.

Definition at line 541 of file Algorithm.h.

IntegerProperty Algorithm::m_outputLevel [private]

Algorithm output level.

Definition at line 542 of file Algorithm.h.

int Algorithm::m_errorMax [private]

Algorithm Max number of errors.

Definition at line 543 of file Algorithm.h.

int Algorithm::m_errorCount [private]

Algorithm error counter.

Definition at line 544 of file Algorithm.h.

BooleanProperty Algorithm::m_auditInit [private]

global flag for auditors

Definition at line 545 of file Algorithm.h.

bool Algorithm::m_auditorInitialize [private]

flag for auditors in "initialize()"

Definition at line 546 of file Algorithm.h.

bool Algorithm::m_auditorReinitialize [private]

flag for auditors in "Reinitialize()"

Definition at line 547 of file Algorithm.h.

bool Algorithm::m_auditorRestart [private]

flag for auditors in "Restart()"

Definition at line 548 of file Algorithm.h.

bool Algorithm::m_auditorExecute [private]

flag for auditors in "execute()"

Definition at line 549 of file Algorithm.h.

bool Algorithm::m_auditorFinalize [private]

flag for auditors in "finalize()"

Definition at line 550 of file Algorithm.h.

bool Algorithm::m_auditorBeginRun [private]

flag for auditors in "beginRun()"

Definition at line 551 of file Algorithm.h.

bool Algorithm::m_auditorEndRun [private]

flag for auditors in "endRun()"

Definition at line 552 of file Algorithm.h.

bool Algorithm::m_auditorStart [private]

flag for auditors in "initialize()"

Definition at line 553 of file Algorithm.h.

bool Algorithm::m_auditorStop [private]

flag for auditors in "Reinitialize()"

Definition at line 554 of file Algorithm.h.

bool Algorithm::m_filterPassed [private]

Filter passed flag.

Definition at line 555 of file Algorithm.h.

bool Algorithm::m_isEnabled [private]

Algorithm is enabled flag.

Definition at line 556 of file Algorithm.h.

bool Algorithm::m_isExecuted [private]

Algorithm is executed flag.

Definition at line 557 of file Algorithm.h.

Gaudi::StateMachine::State Algorithm::m_state [private]

Algorithm has been initialized flag.

Definition at line 558 of file Algorithm.h.

Gaudi::StateMachine::State Algorithm::m_targetState [private]

Algorithm has been initialized flag.

Definition at line 559 of file Algorithm.h.

bool Algorithm::m_isFinalized [private]

Algorithm has been finalized flag.

Definition at line 560 of file Algorithm.h.

---

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

• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiKernel/GaudiKernel/Algorithm.h
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiKernel/src/Lib/Algorithm.cpp