NBRun Class Reference

Class dedicated to the nanobeacon analyses, where the Modules in the detector are not regarded as single entities. More...

#include <NBRun.hh>

Public Member Functions
	NBRun ()
	Default constructor. More...
	NBRun (string filename_, JDetector detector_, int string_, int pmt_top, int pmt_bottom, int max_distance_)
	Constructor. More...
	~NBRun ()
	Destructor. More...
void	computeMeanToTs ()
	Loops over all the SUPERMODULES to compute the mean ToT of the hits from the different nanobeacon pulses recorded by the different PMTs. More...
void	find_good_couples ()
	Loops over all the SUPERMODULES. More...
void	analyze (int option)
	Loops over all the SUPERMODULES. More...
void	readFile ()
	Reads a .root file containing the nanobeacon pulses observed by the different PMTs in the detector. More...
void	findSrcs (SuperModule *sm, TFile *file)
	Searches in the .root file for histograms corresponding to pulses produced in one target supermodule, by all the possible sources. More...
void	setSrcs (TFile *file)
	Loops over all the SuoperModules in the DU. More...
void	setRefs (TFile *file)
	Loops over all the SuoperModules in the DU. More...
void	findRefs (SuperModule *sm, TFile *file)
	Searches in the .root file for histograms corresponding to pulses produced in one supermodule, by its own nanobeacon. More...
vector< SuperModule * >	getSuperModules ()
	Get the SuperModules in the DU. More...
void	setPMTs (int top_option, int bottom_option)
	Select the PMTs in the upper and lower hemispheres of a DOM. More...
void	initializeSuperModules ()
	Sets the references between the different SuperModules in the DU. More...
void	setDetector (JDetector detector_)
	Sets the detector. More...
JDetector	getDetector ()
	Get the detector. More...
void	readBasicInfo (TFile *file)
	Reads the basic info from the .root file such as the run number and the nanobeacon voltage. More...
int	getRunNumber ()
	Get run number. More...
double	getVoltage ()
	Get nanobeacon voltage. More...

Private Attributes
vector< int >	topPMTs
vector< int >	bottomPMTs
vector< int >	srcPMTs
vector< int >	tgtPMTs
int	nSuperModules
int	max_distance
int	string_number
string	filename
int	run_number
double	voltage
JDetector	detector
vector< SuperModule * >	SuperMods

Detailed Description

Class dedicated to the nanobeacon analyses, where the Modules in the detector are not regarded as single entities.

Author

rgruiz Instead, they are related to the rest of the DOMs in a DU through the emission of the nanobeacon pulses. A DOM can be emitter (source) of light that is detected by other DOMS, and it can also be a receiver (target) of the light emitted by the other DOMS. The SUPERRUN class is meant to own the different SUPERMODULEs in a DU, to coherently set their mutual rerefences and to analyze the signal produced by the different nanobeacons in the different PMTs of the DU.

Definition at line 24 of file NBRun.hh.

Constructor & Destructor Documentation

NBRun::NBRun ( )

inline

Default constructor.

Definition at line 50 of file NBRun.hh.

{} ;

NBRun::NBRun ( string  filename_, JDetector  detector_, int  string_, int  pmt_top, int  pmt_bottom, int  max_distance_  )

inline

Constructor.

It initializes the Structure of SuperModules and leaves it ready for analyzing it.

Parameters

filename_	The name of a .root file containing the time vs ToT hit distributions for different PMTs in the DU
detector_	A detector file with the DU that is going to be analyzed.
string_	String number of the string to be analyzed (as it appears in the detector file)
pmt_top	Integer number representing the user's choice
pmt_bottom	Integer number representing the user's choice
max_distance_	Integer number representing the maximum number of neighbors to for each module.

Definition at line 65 of file NBRun.hh.

                                                                                                                 :
    nSuperModules (getNumberOfFloors(detector_)) 
  {
    
    filename = filename_ ;
    
    string_number = string_ ;

    max_distance = max_distance_ ;

    setDetector (detector_) ;
    
    initializeSuperModules () ;

    setPMTs (pmt_top , pmt_bottom) ;

    readFile() ;
    
  }

NBRun::~NBRun ( )

inline

Destructor.

Definition at line 90 of file NBRun.hh.

          {

    for (auto & sm : SuperMods){
 
      delete(sm) ;
    
    }

  };

Member Function Documentation

void NBRun::computeMeanToTs ( )

inline

Loops over all the SUPERMODULES to compute the mean ToT of the hits from the different nanobeacon pulses recorded by the different PMTs.

Definition at line 105 of file NBRun.hh.

                        {

    for (auto & sm : SuperMods){
    
      sm->compute_mean_tot_ref() ;

      sm->compute_mean_tot_tgt() ;

    }

  }

void NBRun::find_good_couples ( )

inline

Loops over all the SUPERMODULES.

For each of them, it searches for good sources and good targets .

Definition at line 122 of file NBRun.hh.

                          {

    for (auto & sm : SuperMods){
    
      sm->select_good_srcs() ;

      sm->select_good_tgts() ;

    }

  }

void NBRun::analyze ( int  option )

inline

Loops over all the SUPERMODULES.

Analyzes the nanobeacon pulses detected by the different PMTs. After they have been analyzed, the method find_good_couples is called.

Parameters

option

Level of analysis of the nanobeacon pulses. 0 for a fast analysis 1 for a fit to a model

Definition at line 140 of file NBRun.hh.

                          {
  
    for (auto & sm : SuperMods){

      switch(option){

      case 0 :
        
        sm->analyzeAll() ;

        break ;

      case 1 :
    
        sm->fitAll() ;
    
        break ;

      }
   
    } 
  
    find_good_couples();

  }

void NBRun::readFile ( )

inline

Reads a .root file containing the nanobeacon pulses observed by the different PMTs in the detector.

Definition at line 170 of file NBRun.hh.

                  {

    TFile* file = TFile::Open(filename.c_str()) ;

    readBasicInfo (file) ;

    setRefs (file) ;
  
    setSrcs (file) ;

  } 

void NBRun::findSrcs ( SuperModule *  sm, TFile *  file  )

inline

Searches in the .root file for histograms corresponding to pulses produced in one target supermodule, by all the possible sources.

Parameters

sm	supermodule
file	root file

Definition at line 190 of file NBRun.hh.

                                              {

    int thisfloor = sm->getFloor () ;

    int thisstring = sm->getString () ;

    vector<SuperModule*> possible_srcs = sm->get_possible_srcs () ;
  
    for (auto & src : possible_srcs){

      int thatfloor = src->getFloor () ;
    
      int thatstring = src->getString () ;

      vector<SuperPMT*> spms ;

      char name[250] ;
    
      for (auto & pm : bottomPMTs){
      
        sprintf(name , "S%dF%d/S%dF%dPMT%d_beaconS%dF%d" , thisstring , thisfloor, thisstring , thisfloor , pm , thatstring , thatfloor);
      
        if (file -> Get (name) ){
        
          TH2D* h = (TH2D*)file -> Get(name) ;
        
          h->SetDirectory(0) ;
        
          JPMT pmt = sm->getPMT ( pm ) ;
        
          SuperPMT* p = new SuperPMT ( pmt , h , pm) ;
        
          spms.push_back (p) ;
        
        }       
      
      }
   
      if(spms.size()>0){
      
        pair < SuperModule* , vector<SuperPMT*> > src_pair (src , spms) ;

        pair < SuperModule* , vector<SuperPMT*> > tgt_pair (sm , spms) ;

        sm->add_src (src_pair) ;

        src->add_tgt (tgt_pair) ;

      }
 
    } 
  
  }

void NBRun::setSrcs ( TFile *  file )

inline

Loops over all the SuoperModules in the DU.

For each supermodule, it calls the findSrcs method.

Parameters

file

root file

Definition at line 251 of file NBRun.hh.

                            {

    for(auto & sm : SuperMods){
    
      findSrcs (sm , file) ;

    }

  }

void NBRun::setRefs ( TFile *  file )

inline

Loops over all the SuoperModules in the DU.

For each supermodule, it calls the findRefs method.

Parameters

file

root file

Definition at line 268 of file NBRun.hh.

                            {

    for (auto & sm : SuperMods){

      findRefs (sm , file) ;

    }

  }

void NBRun::findRefs ( SuperModule *  sm, TFile *  file  )

inline

Searches in the .root file for histograms corresponding to pulses produced in one supermodule, by its own nanobeacon.

Parameters

sm	supermodule
file	root file

Definition at line 286 of file NBRun.hh.

                                                {

    int floor = sm->getFloor () ;

    int string = sm->getString () ;

    char name[250] ;

    for (auto & pm : topPMTs){
  
      sprintf(name , "S%dF%d/S%dF%dPMT%d_beaconS%dF%d" , string , floor, string , floor , pm , string , floor);

      if (file -> Get (name) ){

        TH2D* h = (TH2D*)file -> Get(name) ;

        h->SetDirectory(0) ;

        JPMT pmt = sm->getPMT ( pm ) ;
        
        SuperPMT* p = new SuperPMT (pmt , h , pm) ;

        sm->add_ref_pmt(p) ;

      }
    
    }

  }

vector<SuperModule*> NBRun::getSuperModules ( )

inline

Get the SuperModules in the DU.

Returns

Vector of SuperModules

Definition at line 323 of file NBRun.hh.

                                         {
  
    return SuperMods ;
  
  } 

void NBRun::setPMTs ( int  top_option, int  bottom_option  )

inline

Select the PMTs in the upper and lower hemispheres of a DOM.

Parameters

top_option	user choice
bottom_option	user choice

Definition at line 337 of file NBRun.hh.

                                                   {

    topPMTs = setTopPMTs (top_option) ;

    bottomPMTs = setBottomPMTs (bottom_option) ;
  
  }

void NBRun::initializeSuperModules ( )

inline

Sets the references between the different SuperModules in the DU.

Definition at line 349 of file NBRun.hh.

                               {

    SuperMods.resize(nSuperModules) ;
 
    for (int i = 0 ; i < (int)SuperMods.size() ; i++){

      JModule m = detector.getModule(JModuleLocation(string_number , i+1)) ;

      SuperModule* s_m = new SuperModule (m) ;

      for (int j = i+1 ; (j < i + 1 + max_distance) && (j<(int)nSuperModules) ; j++){
      
        s_m->add_possible_tgt(SuperMods[j]) ;
      
      }

      for (int j = max(i - max_distance , 0) ; j<i ; j++){

        s_m->add_possible_src(SuperMods[j]) ;

      }

      SuperMods[i] = s_m ;

    }

  }

void NBRun::setDetector ( JDetector  detector_ )

inline

Sets the detector.

Parameters

detector_

a JDetector

Definition at line 384 of file NBRun.hh.

                                       {

    detector = detector_ ;

  }

JDetector NBRun::getDetector ( )

inline

Get the detector.

Returns

a JDetector

Definition at line 396 of file NBRun.hh.

                         {
  
    return detector ;

  }

void NBRun::readBasicInfo ( TFile *  file )

inline

Reads the basic info from the .root file such as the run number and the nanobeacon voltage.

Parameters

file

root file

Definition at line 409 of file NBRun.hh.

                                 {
  
    filename = file->GetName() ;

    TVectorD* run_info = (TVectorD*)file->Get("Run_Info") ;

    run_number = (*run_info)(0) ;

    voltage = (*run_info)(1) ;
  
  }

int NBRun::getRunNumber ( )

inline

Get run number.

Returns

run number

Definition at line 427 of file NBRun.hh.

                    {

    return run_number ;

  }

double NBRun::getVoltage ( )

inline

Get nanobeacon voltage.

Returns

nanobeacon voltage

Definition at line 439 of file NBRun.hh.

                     {
  
    return voltage ;

  }

Member Data Documentation

vector<int> NBRun::topPMTs

private

Definition at line 26 of file NBRun.hh.

vector<int> NBRun::bottomPMTs

private

Definition at line 26 of file NBRun.hh.

vector<int> NBRun::srcPMTs

private

Definition at line 26 of file NBRun.hh.

vector<int> NBRun::tgtPMTs

private

Definition at line 26 of file NBRun.hh.

int NBRun::nSuperModules

private

Definition at line 28 of file NBRun.hh.

int NBRun::max_distance

private

Definition at line 30 of file NBRun.hh.

int NBRun::string_number

private

Definition at line 32 of file NBRun.hh.

string NBRun::filename

private

Definition at line 34 of file NBRun.hh.

int NBRun::run_number

private

Definition at line 36 of file NBRun.hh.

double NBRun::voltage

private

Definition at line 38 of file NBRun.hh.

JDetector NBRun::detector

private

Definition at line 40 of file NBRun.hh.

vector<SuperModule*> NBRun::SuperMods

private

Definition at line 42 of file NBRun.hh.

---

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

• NBRun.hh