FrontEnd.h

Go to the documentation of this file.

#ifndef _mdet_FrontEnd_h
#define _mdet_FrontEnd_h

#include <mdet/MComponentGroup.h>
#include <mdet/MDetectorComponent.h>
#include <mdet/Channel.h>

#include <utl/ShadowPtr_fwd.h> // just forward it, to declare friendship.
#include <utl/Validated.h>

#include <Rtypes.h> // allow the use of ULong64_t

namespace det {
  struct ComponentUpdater; // Actually not needed because PMT.h -> MComponentGroup.h -> ComponentGroup.h
}

namespace mdet {

  class Module;

  class FrontEnd :
    public MDetectorComponent<FrontEnd>::Type {
  private:
    typedef MComponentGroup<FrontEnd, Channel, det::ParentCreator>::Type 
      ChannelGroup;
  public:
    class Sampler {
    public:
      bool operator()(double v);
    private:
      friend class FrontEnd;
      Sampler(const FrontEnd& fe);
      bool fLastSample;
      const FrontEnd& fFrontEnd;
    };  

    static const char* const kComponentName;

    static const char* const kComponentId;
    
    typedef std::vector<int> BrokenChannelContainer;
    typedef ChannelGroup::ConstIterator ChannelConstIterator;

    ChannelConstIterator ChannelsBegin()  const {
      return fChannels.Begin();
    }
    ChannelConstIterator ChannelsEnd() const {
      return fChannels.End();
    }
    double GetMeanSampleRatePeriod() const;
    double GetSampleRatePeriodJitter() const;
    unsigned int GetPreT1BufferLength() const; 
    unsigned int GetPostT1BufferLength() const;
    unsigned int GetBufferLength() const { 
      return GetPreT1BufferLength()+GetPostT1BufferLength(); 
    }
//    unsigned int GetExternalMemoryBufferLength() const;
    ULong64_t GetMask() const;

    const BrokenChannelContainer& GetBrokenChannels() const;
    const Module& GetModule() const;
    Sampler MakeSampler() const;
  private:
    void Update(bool invalidateData, bool invalidateComponents);
    double GetTrueRangeLowThreshold() const;
    double GetFalseRangeHiThreshold() const;
    FrontEnd(int fId, const det::VManager::IndexMap& parentMap, const Module& parent);
    ~FrontEnd() { }
    const ChannelGroup& GetChannels() const {
      return fChannels;
    }
    friend class Module;
    friend class utl::ShadowPtr<FrontEnd>;
    template<class A1, class A2, class A3, class A4>
    friend class det::ComponentGroup;

    ChannelGroup fChannels;
    /*
     * Sample rate stuff: Jitter handling.
     */ 
    mutable utl::Validated<double> fMeanSampleRatePeriod;

    mutable utl::Validated<double> fSampleRatePeriodJitter;
    /*
     * Note that managers do not provide unsigned retrievers.
     * So use internally a signed one, and do a cast at the
     * accesor: the interface is kept unsigned as I think
     * that should be (this is the number of bins, no sense to
     * be negative).
     */ 
    mutable utl::Validated<int> fPreT1BufferLength;
    // See fPreT1BufferLength.
    mutable utl::Validated<int> fPostT1BufferLength;
    // See fPreT1BufferLength.
    mutable utl::Validated<int> fExternalMemoryBufferLength;
  
    mutable utl::Validated<double> fTrueRangeLowThreshold;

    mutable utl::Validated<double> fFalseRangeHiThreshold;

    mutable utl::ShadowPtr<BrokenChannelContainer> fBrokenChannels;

    const Module& fModule;
  };

}

#endif // _mdet_FrontEnd_h