JRECONSTRUCTION::JMuonEnergy Class Reference

Auxiliary class to to determine muon energy. More...

#include <JMuonEnergy.hh>

Inheritance diagram for JRECONSTRUCTION::JMuonEnergy:

Classes
struct	JResult
	Auxiliary class for energy estimation. More...

Public Types
typedef JRegressor< JEnergy >	JRegressor_t
typedef JTRIGGER::JHitR1	hit_type
typedef std::vector< hit_type >	buffer_type
typedef JTOOLS::JRange< JEnergy >	JEnergyRange

Public Member Functions
	JMuonEnergy (const JMuonEnergyParameters_t &parameters, const JModuleRouter &router, const JSummaryRouter &summary, const std::string &pdfFile, const int debug=0)
	Constructor.
JEvt	operator() (const KM3NETDAQ::JDAQEvent &event, const JEvt &in)
	Fit function.
void	reset ()
	Reset fit parameters.
bool	equals (const JMuonEnergyParameters_t &parameters) const
	Equality.
	ClassDef (JMuonEnergyParameters_t, 1)

Public Attributes
double	roadWidth_m
	road width [m]
double	R_Hz
	default rate [Hz]
size_t	numberOfPrefits
	number of prefits
double	EMin_log
	minimal energy [log10(GeV)]
double	EMax_log
	maximal energy [log10(GeV)]
double	TMin_ns
	minimal time w.r.t. Cherenkov hypothesis [ns]
double	TMax_ns
	maximal time w.r.t. Cherenkov hypothesis [ns]
double	ZMin_m
	minimal z-position [m]
double	resolution
	energy resolution [log10(GeV)]
int	mestimator
	M-estimator.
bool	reprocess
	reprocess

Private Attributes
const JModuleRouter &	router
const JSummaryRouter &	summary
int	debug

Detailed Description

Auxiliary class to to determine muon energy.

Definition at line 58 of file JMuonEnergy.hh.

Member Typedef Documentation

JRegressor_t

JRegressor<JEnergy> JRECONSTRUCTION::JMuonEnergy::JRegressor_t

Definition at line 63 of file JMuonEnergy.hh.

hit_type

JTRIGGER::JHitR1 JRECONSTRUCTION::JMuonEnergy::hit_type

Definition at line 64 of file JMuonEnergy.hh.

buffer_type

std::vector<hit_type> JRECONSTRUCTION::JMuonEnergy::buffer_type

Definition at line 65 of file JMuonEnergy.hh.

JEnergyRange

JTOOLS::JRange<JEnergy> JRECONSTRUCTION::JMuonEnergy::JEnergyRange

Definition at line 66 of file JMuonEnergy.hh.

Constructor & Destructor Documentation

JMuonEnergy()

JRECONSTRUCTION::JMuonEnergy::JMuonEnergy ( const JMuonEnergyParameters_t & parameters, const JModuleRouter & router, const JSummaryRouter & summary, const std::string & pdfFile, const int debug = 0 )

inline

Constructor.

Parameters

parameters	parameters
router	module router
summary	summary router
pdfFile	PDF file
debug	debug

Definition at line 79 of file JMuonEnergy.hh.

                                                         :
      JMuonEnergyParameters_t(parameters),
      JRegressor_t(pdfFile),
      router(router), 
      summary(summary),
      debug(debug)
    {
      using namespace JPP;
      
      JRegressor_t::debug  = debug;
      JRegressor_t::T_ns.setRange(TMin_ns, TMax_ns);
 
      if (this->getRmax() < roadWidth_m) {
        roadWidth_m = this->getRmax();
      }
 
      this->estimator.reset(getMEstimator(mestimator));
 
      if (!this->estimator.is_valid()) {
        FATAL("Invalid M-Estimator." << endl);
      }
    }

Member Function Documentation

operator()()

JEvt JRECONSTRUCTION::JMuonEnergy::operator() ( const KM3NETDAQ::JDAQEvent & event, const JEvt & in )

inline

Fit function.

Parameters

event	event
in	start values

Returns

fit results

Definition at line 146 of file JMuonEnergy.hh.

    {  
      using namespace std;
      using namespace JPP;
 
      JEvt out;
 
      typedef vector<JHitL0>  JDataL0_t;
      const JBuildL0<JHitL0>  buildL0;
 
      const JDetector& detector = router.getReference();
 
      JDataL0_t dataL0;
 
      buildL0(JDAQTimeslice(event, true), router, back_inserter(dataL0));
 
      for (JEvt::const_iterator track = in.begin(); track != in.end(); ++track) {
 
        const JRotation3D           R (getDirection(*track));
        const JLine1Z               tz(getPosition (*track).rotate(R), track->getT());
        const JFIT::JModel<JLine1Z> match(tz, roadWidth_m, JRegressor_t::T_ns);
        
        multiset<JDAQPMTIdentifier> top;
 
        vector<JNPEHit> data;
 
        for (JDataL0_t::const_iterator i = dataL0.begin(); i !=dataL0.end(); ++i) {
 
          JHitR1 hit(*i);
          
          hit.rotate(R);
          
          if (match(hit)) {
            top.insert(i->getPMTIdentifier());
          }
        }
        
        JRange<double> Z_m;
        
        if ( track->hasW(JSTART_LENGTH_METRES) && track->getW(JSTART_LENGTH_METRES) > 0.0 ) {
          Z_m.setLowerLimit(this->ZMin_m);
        }
 
        const JDetectorSubset_t subdetector(detector, getAxis(*track), roadWidth_m, Z_m);
        
        for (JDetector::const_iterator module = subdetector.begin(); module != subdetector.end(); ++module) {
          
          if (summary.hasSummaryFrame(module->getID())) {
            
            const JDAQSummaryFrame& frame = summary.getSummaryFrame(module->getID());
            
            for (size_t i = 0; i != module->size(); ++i) {
              
              if (getDAQStatus(frame, *module, i)            &&
                  getPMTStatus(frame, *module, i)            &&
                  frame[i].is_valid()                        &&
                  !module->getPMT(i).has(PMT_DISABLE)) {
 
                const JDAQPMTIdentifier id(module->getID(), i);
                
                const double rate_Hz = summary.getRate(id);
                const size_t count   = top.count(id);
                
                data.push_back(JNPEHit(this->getNPE(module->getPMT(i), rate_Hz), count));
              }
            }
          }
        }
        
        const int NDF = distance(data.begin(), data.end()) - 1;
 
        if( NDF >= 0 ) {
          
          // 5-point search between given limits
 
          const int      N  =  5;
          
          JResult result[N];
          
          for (int i = 0; i != N; ++i) {
            result[i].x = EMin_log + i * (EMax_log - EMin_log) / (N-1);
          }
          
          map<double, double> buffer;
          
          do {
            
            int j = 0;
            
            for (int i = 0; i != N; ++i) {
              
              if (!result[i]) {
                
                const JEnergy x    = result[i].x;
                const double  chi2 = (*this)(x, data.begin(), data.end());
                
                result[i].chi2 = chi2;
                buffer[chi2]   = x.getE();
              }
              
              if (result[i].chi2 < result[j].chi2) {
                j = i;
              }
            }  
            
            
            for (int i = 0; i != N; ++i) {
              DEBUG(' ' << FIXED(5,2) << result[i].x << ' ' << FIXED(9,3) << result[i].chi2);
            }
            DEBUG(endl);
            
            // squeeze range
            
            switch (j) {
              
            case 0:
              result[4] = result[1];
              result[2] = result[0];
              result[0] = JResult(2*result[2].x - result[4].x);
              break;
              
            case 1:
              result[4] = result[2];
              result[2] = result[1];
              break;
              
            case 2:
              result[0] = result[1];
              result[4] = result[3];
              break;
              
            case 3:
              result[0] = result[2];
              result[2] = result[3];
              break;
              
            case 4:
              result[0] = result[3];
              result[2] = result[4];
              result[4] = JResult(2*result[2].x - result[0].x);
              break;
            }
            
            result[1] = JResult(0.5 * (result[0].x + result[2].x));
            result[3] = JResult(0.5 * (result[2].x + result[4].x));
            
          } while (result[4].x - result[0].x > resolution);
          
          
          if (result[1].chi2 != result[3].chi2) {
            
            result[2].x    += 0.25 * (result[3].x - result[1].x) * (result[1].chi2 - result[3].chi2) / (result[1].chi2 + result[3].chi2 - 2*result[2].chi2);
            result[2].chi2  = (*this)(result[2].x, data.begin(), data.end());
            
          }
          
          const double chi2 = result[2].chi2;
          const double E    = result[2].x.getE();
          
          // calculate additional variables
 
          double Emin = numeric_limits<double>::max();
          double Emax = numeric_limits<double>::lowest();
          
          for (map<double, double>::const_iterator i = buffer.begin(); i != buffer.end() && i->first <= chi2 + 1.0; ++i) {
            if (i->second < Emin) { Emin = i->second; }
            if (i->second > Emax) { Emax = i->second; }
          }
          
          const double mu_range   = gWater(E);           // range of a muon with the reconstructed energy
          
          double noise_likelihood = 0.0;                 // log-likelihood of every hit being from K40   
          int    number_of_hits   = 0;                   // number of hits selected for JEnergy
          
          for (vector<JNPEHit>::const_iterator i = data.begin(); i != data.end(); ++i) {
            noise_likelihood += log10(getP(i->getY0(), i->getN()));       // probability of getting the observed multiplicity with K40 
            number_of_hits   += i->getN();                                // hit multiplicity
          }
            
          out.push_back(JFit(*track).add(JMUONENERGY));
 
          out.rbegin()->setE(E);
 
          out.rbegin()->setW(track->getW());
          out.rbegin()->setW(JENERGY_ENERGY,            E);
          out.rbegin()->setW(JENERGY_CHI2,              chi2);
          out.rbegin()->setW(JENERGY_MUON_RANGE_METRES, mu_range);
          out.rbegin()->setW(JENERGY_NOISE_LIKELIHOOD,  noise_likelihood);
          out.rbegin()->setW(JENERGY_NDF,               NDF);
          out.rbegin()->setW(JENERGY_NUMBER_OF_HITS,    number_of_hits);
          out.rbegin()->setW(JENERGY_MINIMAL_ENERGY,    Emin);
          out.rbegin()->setW(JENERGY_MAXIMAL_ENERGY,    Emax);
        }
      }
 
      return out;
    }

reset()

void JRECONSTRUCTION::JMuonEnergyParameters_t::reset ( )

inlineinherited

Reset fit parameters.

Definition at line 44 of file JMuonEnergyParameters_t.hh.

    {
      roadWidth_m     = std::numeric_limits<double>::max();
      R_Hz            = 6.0e3;
      numberOfPrefits = 0;
      EMin_log        = 1.0;
      EMax_log        = 8.0;
      TMin_ns         =  -50.0;     
      TMax_ns         = +450.0;     
      ZMin_m          = std::numeric_limits<double>::lowest();
      resolution      = 0.01;
      mestimator      = JFIT::EM_NORMAL;
      reprocess       = false;
    }

equals()

bool JRECONSTRUCTION::JMuonEnergyParameters_t::equals ( const JMuonEnergyParameters_t & parameters ) const

inlineinherited

Equality.

Parameters

parameters

fit parameters

Returns

true if equals; else false

Definition at line 65 of file JMuonEnergyParameters_t.hh.

    {
      return (this->roadWidth_m      == parameters.roadWidth_m     &&
              this->R_Hz             == parameters.R_Hz            &&
              this->numberOfPrefits  == parameters.numberOfPrefits &&
              this->EMin_log         == parameters.EMin_log        &&
              this->EMax_log         == parameters.EMax_log        &&
              this->TMin_ns          == parameters.TMin_ns         &&
              this->TMax_ns          == parameters.TMax_ns         &&
              this->ZMin_m           == parameters.ZMin_m          &&
              this->resolution       == parameters.resolution      &&
              this->mestimator       == parameters.mestimator      &&
              this->reprocess        == parameters.reprocess);
    }

ClassDef()

JRECONSTRUCTION::JMuonEnergyParameters_t::ClassDef ( JMuonEnergyParameters_t , 1  )

inherited

Member Data Documentation

router

const JModuleRouter& JRECONSTRUCTION::JMuonEnergy::router

private

Definition at line 345 of file JMuonEnergy.hh.

summary

const JSummaryRouter& JRECONSTRUCTION::JMuonEnergy::summary

private

Definition at line 346 of file JMuonEnergy.hh.

debug

int JRECONSTRUCTION::JMuonEnergy::debug

private

Definition at line 347 of file JMuonEnergy.hh.

roadWidth_m

double JRECONSTRUCTION::JMuonEnergyParameters_t::roadWidth_m

inherited

road width [m]

Definition at line 82 of file JMuonEnergyParameters_t.hh.

R_Hz

double JRECONSTRUCTION::JMuonEnergyParameters_t::R_Hz

inherited

default rate [Hz]

Definition at line 83 of file JMuonEnergyParameters_t.hh.

numberOfPrefits

size_t JRECONSTRUCTION::JMuonEnergyParameters_t::numberOfPrefits

inherited

number of prefits

Definition at line 84 of file JMuonEnergyParameters_t.hh.

EMin_log

double JRECONSTRUCTION::JMuonEnergyParameters_t::EMin_log

inherited

minimal energy [log10(GeV)]

Definition at line 85 of file JMuonEnergyParameters_t.hh.

EMax_log

double JRECONSTRUCTION::JMuonEnergyParameters_t::EMax_log

inherited

maximal energy [log10(GeV)]

Definition at line 86 of file JMuonEnergyParameters_t.hh.

TMin_ns

double JRECONSTRUCTION::JMuonEnergyParameters_t::TMin_ns

inherited

minimal time w.r.t. Cherenkov hypothesis [ns]

Definition at line 87 of file JMuonEnergyParameters_t.hh.

TMax_ns

double JRECONSTRUCTION::JMuonEnergyParameters_t::TMax_ns

inherited

maximal time w.r.t. Cherenkov hypothesis [ns]

Definition at line 88 of file JMuonEnergyParameters_t.hh.

ZMin_m

double JRECONSTRUCTION::JMuonEnergyParameters_t::ZMin_m

inherited

minimal z-position [m]

Definition at line 89 of file JMuonEnergyParameters_t.hh.

resolution

double JRECONSTRUCTION::JMuonEnergyParameters_t::resolution

inherited

energy resolution [log10(GeV)]

Definition at line 90 of file JMuonEnergyParameters_t.hh.

mestimator

int JRECONSTRUCTION::JMuonEnergyParameters_t::mestimator

inherited

M-estimator.

Definition at line 91 of file JMuonEnergyParameters_t.hh.

reprocess

bool JRECONSTRUCTION::JMuonEnergyParameters_t::reprocess

inherited

reprocess

Definition at line 92 of file JMuonEnergyParameters_t.hh.

---

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

• JMuonEnergy.hh