| The Gaudi Framework v27r1

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Files

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Member Functions | Private Attributes | List of all members
RndmGenSvc Class Reference

Random Generator service definition. More...

`#include <src/RndmGenSvc/RndmGenSvc.h>`

Inheritance diagram for RndmGenSvc:
[legend]
Collaboration diagram for RndmGenSvc:
[legend]

## Public Member Functions
| RndmGenSvc (const std::string &name, ISvcLocator *svc)
| Standard Service constructor. More...
| ~RndmGenSvc () override=default
| Standard Service destructor. More...
StatusCode | initialize () override
| Service override: initialization. More...
StatusCode | finalize () override
| Service override: finalization. More...
StreamBuffer & | serialize (StreamBuffer &str) override
| IRndmGenSvc interface implementation. More...
StreamBuffer & | serialize (StreamBuffer &str) const override
| Output serialization to stream buffer. Saves the status of the generator engine. More...
IRndmEngine * | engine () override
| Retrieve engine. More...
StatusCode | generator (const IRndmGen::Param &par, IRndmGen *&refpGen) override
| Retrieve a valid generator from the service. More...
double | rndm () const override
| Single shot returning single random number. More...
StatusCode | rndmArray (std::vector< double > &array, long howmany, long start=0) const override
| Multiple shots returning vector with flat random numbers. More...
StatusCode | setSeeds (const std::vector< long > &seeds) override
| Allow to set new seeds. More...
StatusCode | seeds (std::vector< long > &seeds) const override
| Allow to get seeds. More...
Public Member Functions inherited from extends< Service, IRndmGenSvc, IRndmEngine, ISerialize >
void * | i_cast (const InterfaceID &tid) const override
| Implementation of IInterface::i_cast. More...
StatusCode | queryInterface (const InterfaceID &ti, void **pp) override
| Implementation of IInterface::queryInterface. More...
std::vector< std::string > | getInterfaceNames () const override
| Implementation of IInterface::getInterfaceNames. More...
| ~extends () override=default
| Virtual destructor. More...
Public Member Functions inherited from Service
const std::string & | name () const override
| Retrieve name of the service. More...
StatusCode | configure () override
StatusCode | initialize () override
StatusCode | start () override
StatusCode | stop () override
StatusCode | finalize () override
StatusCode | terminate () override
Gaudi::StateMachine::State | FSMState () const override
Gaudi::StateMachine::State | targetFSMState () const override
StatusCode | reinitialize () override
StatusCode | restart () override
StatusCode | sysInitialize () override
| Initialize Service. More...
StatusCode | sysStart () override
| Initialize Service. More...
StatusCode | sysStop () override
| Initialize Service. More...
StatusCode | sysFinalize () override
| Finalize Service. More...
StatusCode | sysReinitialize () override
| Re-initialize the Service. More...
StatusCode | sysRestart () override
| Re-initialize the Service. More...
StatusCode | setProperty (const Property &p) override
StatusCode | setProperty (const std::string &s) override
StatusCode | setProperty (const std::string &n, const std::string &v) override
StatusCode | getProperty (Property *p) const override
const Property & | getProperty (const std::string &name) const override
StatusCode | getProperty (const std::string &n, std::string &v) const override
const std::vector< Property * > & | getProperties () const override
bool | hasProperty (const std::string &name) const override
template<class TYPE >
StatusCode | setProperty (const std::string &name, const TYPE &value)
| set the property form the value More...
| Service (std::string name, ISvcLocator *svcloc)
| Standard Constructor. More...
SmartIF< ISvcLocator > & | serviceLocator () const override
| Retrieve pointer to service locator. More...
StatusCode | setProperties ()
| Method for setting declared properties to the values specified for the job. More...
template<class T >
StatusCode | service (const std::string &name, const T *&psvc, bool createIf=true) const
| Access a service by name, creating it if it doesn't already exist. More...
template<class T >
StatusCode | service (const std::string &name, T *&psvc, bool createIf=true) const
template<typename IFace = IService>
SmartIF< IFace > | service (const std::string &name, bool createIf=true) const
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. More...
template<class T >
Property * | declareProperty (const std::string &name, T &property, const std::string &doc="none") const
| Declare the named property. More...
Property * | declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
| Declare remote named properties. More...
template<class T >
StatusCode | declarePrivateTool (ToolHandle< T > &handle, std::string toolTypeAndName="", bool createIf=true)
| Declare used Private tool. More...
template<class T >
StatusCode | declarePublicTool (ToolHandle< T > &handle, std::string toolTypeAndName="", bool createIf=true)
| Declare used Public tool. More...
SmartIF< IAuditorSvc > & | auditorSvc () const
| The standard auditor service.May not be invoked before sysInitialize() has been invoked. More...
Public Member Functions inherited from CommonMessagingBase
virtual | ~CommonMessagingBase ()=default
| Virtual destructor. More...
SmartIF< IMessageSvc > & | msgSvc () const
| The standard message service. More...
MsgStream & | msgStream () const
| Return an uninitialized MsgStream. More...
MsgStream & | msgStream (const MSG::Level level) const
| Predefined configurable message stream for the efficient printouts. More...
MsgStream & | always () const
| shortcut for the method msgStream(MSG::ALWAYS) More...
MsgStream & | fatal () const
| shortcut for the method msgStream(MSG::FATAL) More...
MsgStream & | err () const
| shortcut for the method msgStream(MSG::ERROR) More...
MsgStream & | error () const
| shortcut for the method msgStream(MSG::ERROR) More...
MsgStream & | warning () const
| shortcut for the method msgStream(MSG::WARNING) More...
MsgStream & | info () const
| shortcut for the method msgStream(MSG::INFO) More...
MsgStream & | debug () const
| shortcut for the method msgStream(MSG::DEBUG) More...
MsgStream & | verbose () const
| shortcut for the method msgStream(MSG::VERBOSE) More...
MsgStream & | msg () const
| shortcut for the method msgStream(MSG::INFO) More...
MSG::Level | msgLevel () const
| get the output level from the embedded MsgStream More...
MSG::Level | outputLevel () const __attribute__((deprecated))
| Backward compatibility function for getting the output level. More...
bool | msgLevel (MSG::Level lvl) const
| get the output level from the embedded MsgStream More...
Public Member Functions inherited from extend_interfaces< Interfaces...>
| ~extend_interfaces () override=default
| Virtual destructor. More...

## Private Attributes
SmartIF< IRndmEngine > | m_engine
| Random number engine. More...
SmartIF< ISerialize > | m_serialize
| Serialization interface of random number engine. More...
std::string | m_engineName
| Engine name. More...

## Additional Inherited Members
Public Types inherited from extends< Service, IRndmGenSvc, IRndmEngine, ISerialize >
using | base_class = extends
| Typedef to this class. More...
using | extend_interfaces_base = extend_interfaces< Interfaces...>
| Typedef to the base of this class. More...
Public Types inherited from Service
typedef Gaudi::PluginService::Factory< IService *, const std::string &, ISvcLocator * > | Factory
Public Types inherited from CommonMessaging< implements< IService, IProperty, IStateful > >
using | base_class = CommonMessaging
Public Types inherited from extend_interfaces< Interfaces...>
using | ext_iids = typename Gaudi::interface_list_cat< typename Interfaces::ext_iids...>::type
| take union of the ext_iids of all Interfaces... More...
Protected Member Functions inherited from Service
| ~Service () override
| Standard Destructor. More...
int | outputLevel () const
| get the `Service's` output level More...
Protected Member Functions inherited from CommonMessaging< implements< IService, IProperty, IStateful > >
void | updateMsgStreamOutputLevel (int level)
| Update the output level of the cached MsgStream. More...
Protected Attributes inherited from Service
IntegerProperty | m_outputLevel = MSG::NIL
| Service output level. More...
Gaudi::StateMachine::State | m_state = Gaudi::StateMachine::OFFLINE
| Service state. More...
Gaudi::StateMachine::State | m_targetState = Gaudi::StateMachine::OFFLINE
| Service state. More...

## Detailed Description

Random Generator service definition.

Description: Definition of a interface for a service to access random generators according to predefined distributions. For more detailed explanations please see the interface definition.

Dependencies:

- Base class: Gaudi/RndmGenSvc/ISerialize.h
- Base class: Gaudi/RndmGenSvc/IRandomGenSvc.h

History :

    +---------+----------------------------------------------+--------+
    |    Date |                 Comment                      | Who    |
    +---------+----------------------------------------------+--------+
    | 21/04/99| Initial version.                             | MF     |
    +---------+----------------------------------------------+--------+

Author: M.Frank Version: 1.0

Definition at line 49 of file RndmGenSvc.h.

## Constructor & Destructor Documentation

RndmGenSvc::RndmGenSvc | ( | const std::string & | name,
|  | ISvcLocator * | svc
| ) |  |

Standard Service constructor.

Definition at line 35 of file RndmGenSvc.cpp.

36 : base_class(nam, svc)
37 {
38 declareProperty("Engine", m_engineName = "HepRndm::Engine<CLHEP::RanluxEngine>");
39 }
RndmGenSvc::m_engineName
std::string m_engineName
Engine name.
Definition: RndmGenSvc.h:59
extends< Service, IRndmGenSvc, IRndmEngine, ISerialize >::base_class
extends base_class
Typedef to this class.
Definition: extends.h:14
Service::declareProperty
Property * declareProperty(const std::string &name, T &property, const std::string &doc="none") const
Declare the named property.
Definition: Service.h:215

RndmGenSvc::~RndmGenSvc | ( |  | ) |
| override default

Standard Service destructor.

## Member Function Documentation

IRndmEngine * RndmGenSvc::engine | ( |  | ) |
| override

Retrieve engine.

Definition at line 102 of file RndmGenSvc.cpp.

102 {
103 return m_engine.get();
104 }
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
SmartIF::get
TYPE * get() const
Get interface pointer.
Definition: SmartIF.h:76

StatusCode RndmGenSvc::finalize | ( |  | ) |
| override

Service override: finalization.

Definition at line 76 of file RndmGenSvc.cpp.

76 {
77 StatusCode status = Service::finalize();
78 m_serialize.reset();
79 if ( m_engine ) {
80 m_engine.as<IService>()->finalize().ignore();
81 m_engine.reset();
82 }
83 return status;
84 }
Service::finalize
StatusCode finalize() override
Definition: Service.cpp:193
RndmGenSvc::finalize
StatusCode finalize() override
Service override: finalization.
Definition: RndmGenSvc.cpp:76
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
SmartIF::as
SmartIF< IFace > as() const
return a new SmartIF instance to another interface
Definition: SmartIF.h:110
IService
General service interface definition.
Definition: IService.h:18
StatusCode
This class is used for returning status codes from appropriate routines.
Definition: StatusCode.h:26
SmartIF::reset
void reset(TYPE *ptr=nullptr)
Set the internal pointer to the passed one disposing of the old one.
Definition: SmartIF.h:88
RndmGenSvc::m_serialize
SmartIF< ISerialize > m_serialize
Serialization interface of random number engine.
Definition: RndmGenSvc.h:57
StatusCode::ignore
void ignore() const
Definition: StatusCode.h:108

StatusCode RndmGenSvc::generator | ( | const IRndmGen::Param & | par,
|  | IRndmGen *& | refpGen
| ) |  |
| override

Retrieve a valid generator from the service.

Definition at line 107 of file RndmGenSvc.cpp.

107 {
108 auto pGen = SmartIF<IRndmGen>( ObjFactory::create(par.type(),m_engine.get()) );
109 if (!pGen) {
110 refpGen = nullptr;
111 return StatusCode::FAILURE;
112 }
113 refpGen = pGen.get();
114 refpGen->addRef(); // insure the caller gets something with a refCount of (at least) one back...
115 return refpGen->initialize(par);
116 }
IRndmGen::initialize
virtual StatusCode initialize(const IRndmGen::Param &par)=0
Initialize the generator.
SmartIF< IRndmGen >
IRndmGen::Param::type
virtual const InterfaceID & type() const
Parameter's type.
Definition: IRndmGen.h:50
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
SmartIF::get
TYPE * get() const
Get interface pointer.
Definition: SmartIF.h:76
StatusCode::FAILURE
Definition: StatusCode.h:29
IInterface::addRef
virtual unsigned long addRef()=0
Increment the reference count of Interface instance.

StatusCode RndmGenSvc::initialize | ( |  | ) |
| override

Service override: initialization.

Definition at line 42 of file RndmGenSvc.cpp.

42 {
43 StatusCode status = Service::initialize();
44
45 auto mgr = serviceLocator()->as<ISvcManager>();
46
47 if ( status.isSuccess() ) {
48 status = setProperties();
49 if ( status.isSuccess() ) { // Check if the Engine service exists:
50 // FIXME: (MCl) why RndmGenSvc cannot create the engine service in a standard way?
51 const bool CREATE = false;
52 std::string machName = name()+".Engine";
53 auto engine = serviceLocator()->service<IRndmEngine>(machName, CREATE);
54 if ( !engine && mgr ) {
55 using Gaudi::Utils::TypeNameString;
56 engine = mgr->createService(TypeNameString(machName, m_engineName));
57 }
58 if ( engine ) {
59 auto serial = engine.as<ISerialize>();
60 auto service = engine.as<IService>();
61 if ( serial && service ) {
62 status = service->sysInitialize();
63 if ( status.isSuccess() ) {
64 m_engine = engine;
65 m_serialize = serial;
66 info() << "Using Random engine:" << m_engineName << endmsg;
67 }
68 }
69 }
70 }
71 }
72 return status;
73 }
Service::initialize
StatusCode initialize() override
Definition: Service.cpp:68
Service::serviceLocator
SmartIF< ISvcLocator > & serviceLocator() const override
Retrieve pointer to service locator.
Definition: Service.cpp:324
CommonMessagingBase::info
MsgStream & info() const
shortcut for the method msgStream(MSG::INFO)
Definition: CommonMessaging.h:124
ISvcManager
The ISvcManager is the interface implemented by the Service Factory in the Application Manager to sup...
Definition: ISvcManager.h:28
StatusCode::isSuccess
bool isSuccess() const
Test for a status code of SUCCESS.
Definition: StatusCode.h:76
RndmGenSvc::m_engineName
std::string m_engineName
Engine name.
Definition: RndmGenSvc.h:59
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
ISvcLocator::as
SmartIF< IFace > as()
Definition: ISvcLocator.h:106
std::string
STL class.
ISvcLocator::service
StatusCode service(const Gaudi::Utils::TypeNameString &name, T *&svc, bool createIf=true)
Templated method to access a service by name.
Definition: ISvcLocator.h:78
Service::name
const std::string & name() const override
Retrieve name of the service.
Definition: Service.cpp:319
Gaudi::Utils::TypeNameString
Helper class to parse a string of format "type/name".
Definition: TypeNameString.h:9
IService
General service interface definition.
Definition: IService.h:18
StatusCode
This class is used for returning status codes from appropriate routines.
Definition: StatusCode.h:26
Service::setProperties
StatusCode setProperties()
Method for setting declared properties to the values specified for the job.
Definition: Service.cpp:363
Io::CREATE
Definition: IFileMgr.h:30
Service::service
StatusCode service(const std::string &name, const T *&psvc, bool createIf=true) const
Access a service by name, creating it if it doesn't already exist.
Definition: Service.h:144
IRndmEngine
Definition of a interface for a generic random number generator giving randomly distributed numbers i...
Definition: IRndmEngine.h:19
RndmGenSvc::engine
IRndmEngine * engine() override
Retrieve engine.
Definition: RndmGenSvc.cpp:102
RndmGenSvc::m_serialize
SmartIF< ISerialize > m_serialize
Serialization interface of random number engine.
Definition: RndmGenSvc.h:57
ISerialize
Object serialization interface definition.
Definition: ISerialize.h:17
endmsg
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244

double RndmGenSvc::rndm | ( |  | ) | const
| override

Single shot returning single random number.

Definition at line 119 of file RndmGenSvc.cpp.

119 {
120 return m_engine ? m_engine->rndm() : -1;
121 }
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
IRndmEngine::rndm
virtual double rndm() const =0
Single shot returning single random number.

StatusCode RndmGenSvc::rndmArray | ( | std::vector< double > & | array,
|  | long | howmany,
|  | long | start = `0`
| ) |  | const
| override

Multiple shots returning vector with flat random numbers.

Parameters

  array | Array containing random numbers
  howmany | fill 'howmany' random numbers into array
  start | ... starting at position start

Returns
  StatusCode indicating failure or success.

Definition at line 129 of file RndmGenSvc.cpp.

129 {
130 return m_engine ? m_engine->rndmArray(array, howmany, start)
131 : StatusCode::FAILURE;
132 }
IRndmEngine::rndmArray
virtual StatusCode rndmArray(std::vector< double > &array, long howmany, long start=0) const =0
Multiple shots returning vector with flat random numbers.
Service::start
StatusCode start() override
Definition: Service.cpp:152
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
StatusCode::FAILURE
Definition: StatusCode.h:29

StatusCode RndmGenSvc::seeds | ( | std::vector< long > & | seeds | ) | const
| override

Allow to get seeds.

Definition at line 141 of file RndmGenSvc.cpp.

141 {
142 return m_engine ? m_engine->seeds(seeds)
143 : StatusCode::FAILURE;
144 }
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
StatusCode::FAILURE
Definition: StatusCode.h:29
IRndmEngine::seeds
virtual StatusCode seeds(std::vector< long > &seeds) const =0
Allow to retrieve seeds.

StreamBuffer & RndmGenSvc::serialize | ( | StreamBuffer & | str | ) |
| override

IRndmGenSvc interface implementation.

Input serialization from stream buffer. Restores the status of the generator engine.

Definition at line 88 of file RndmGenSvc.cpp.

88 {
89 if ( m_serialize ) return m_serialize->serialize(str);
90 error() << "Cannot input serialize Generator settings!" << endmsg;
91 return str;
92 }
CommonMessagingBase::error
MsgStream & error() const
shortcut for the method msgStream(MSG::ERROR)
Definition: CommonMessaging.h:118
ISerialize::serialize
virtual StreamBuffer & serialize(StreamBuffer &str)=0
Input serialization from stream buffer.
RndmGenSvc::m_serialize
SmartIF< ISerialize > m_serialize
Serialization interface of random number engine.
Definition: RndmGenSvc.h:57
endmsg
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244

StreamBuffer & RndmGenSvc::serialize | ( | StreamBuffer & | str | ) | const
| override

Output serialization to stream buffer. Saves the status of the generator engine.

Definition at line 95 of file RndmGenSvc.cpp.

95 {
96 if ( m_serialize ) return m_serialize->serialize(str);
97 error() << "Cannot output serialize Generator settings!" << endmsg;
98 return str;
99 }
CommonMessagingBase::error
MsgStream & error() const
shortcut for the method msgStream(MSG::ERROR)
Definition: CommonMessaging.h:118
ISerialize::serialize
virtual StreamBuffer & serialize(StreamBuffer &str)=0
Input serialization from stream buffer.
RndmGenSvc::m_serialize
SmartIF< ISerialize > m_serialize
Serialization interface of random number engine.
Definition: RndmGenSvc.h:57
endmsg
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244

StatusCode RndmGenSvc::setSeeds | ( | const std::vector< long > & | seeds | ) |
| override

Allow to set new seeds.

Definition at line 135 of file RndmGenSvc.cpp.

135 {
136 return m_engine ? m_engine->setSeeds(seeds)
137 : StatusCode::FAILURE;
138 }
RndmGenSvc::m_engine
SmartIF< IRndmEngine > m_engine
Random number engine.
Definition: RndmGenSvc.h:55
StatusCode::FAILURE
Definition: StatusCode.h:29
IRndmEngine::setSeeds
virtual StatusCode setSeeds(const std::vector< long > &seeds)=0
Allow to set new seeds.

## Member Data Documentation

SmartIF<IRndmEngine> RndmGenSvc::m_engine
| mutable private

Random number engine.

Definition at line 55 of file RndmGenSvc.h.

std::string RndmGenSvc::m_engineName
| private

Engine name.

Definition at line 59 of file RndmGenSvc.h.

SmartIF<ISerialize> RndmGenSvc::m_serialize
| mutable private

Serialization interface of random number engine.

Definition at line 57 of file RndmGenSvc.h.

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

- GaudiSvc/src/RndmGenSvc/RndmGenSvc.h
- GaudiSvc/src/RndmGenSvc/RndmGenSvc.cpp