RandomNumberGenerator.h

Go to the documentation of this file.

#ifndef FWCore_Utilities_RandomNumberGenerator_h
#define FWCore_Utilities_RandomNumberGenerator_h

#include <vector>
#include <stdint.h>

class RandomEngineState;

namespace CLHEP {
  class HepRandomEngine;
}

namespace edm {

  class StreamID;
  class LuminosityBlock;
  class LuminosityBlockIndex;
  class Event;

  class RandomNumberGenerator
  {
  public:

    RandomNumberGenerator() {}
    virtual ~RandomNumberGenerator();

    virtual CLHEP::HepRandomEngine& getEngine() const = 0;    

    virtual CLHEP::HepRandomEngine& getEngine(StreamID const&) const { return getEngine(); }
    virtual CLHEP::HepRandomEngine& getEngine(LuminosityBlockIndex const&) const { return getEngine(); }

    virtual uint32_t mySeed() const = 0;

    // The following functions should not be used by general users.  They
    // should only be called by Framework code designed to work with the
    // service while it is saving the engine states or restoring them.
    // The first two are called by the InputSource base class.
    // The next two are called by a dedicated producer module (RandomEngineStateProducer).

    virtual void preBeginLumi(LuminosityBlock const& lumi) = 0;
    virtual void postEventRead(Event const& event) = 0;

    virtual std::vector<RandomEngineState> const& getLumiCache() const = 0;
    virtual std::vector<RandomEngineState> const& getEventCache() const = 0;
 
    virtual void print() = 0;

  private:

    RandomNumberGenerator(RandomNumberGenerator const&); // stop default
    RandomNumberGenerator const& operator=(RandomNumberGenerator const&); // stop default
  };
}
#endif