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() [1/2]

NBRun::NBRun ( )

inline

Default constructor.

Definition at line 50 of file NBRun.hh.

50 {} ;

◆ NBRun() [2/2]

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::~NBRun ( )

inline

Destructor.

Definition at line 90 of file NBRun.hh.

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

Member Function Documentation

◆ computeMeanToTs()

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() ;
  
     }
  
   }

◆ find_good_couples()

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() ;
  
     }
  
   }

◆ analyze()

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();
  
   }

◆ readFile()

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) ;
  
   }

◆ findSrcs()

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) ;
  
       }
  
     } 
   
   }

◆ setSrcs()

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) ;
  
     }
  
   }

◆ setRefs()

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) ;
  
     }
  
   }

◆ findRefs()

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) ;
  
       }
     
     }
  
   }

◆ getSuperModules()

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 ;
   
   } 

◆ setPMTs()

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) ;
   
   }

◆ initializeSuperModules()

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 ;
  
     }
  
   }

◆ setDetector()

void NBRun::setDetector ( JDetector detector_ )

inline

Sets the detector.

Parameters

detector_ a JDetector

Definition at line 384 of file NBRun.hh.

                                        {
  
     detector = detector_ ;
  
   }

◆ getDetector()

JDetector NBRun::getDetector ( )

inline

Get the detector.

Returns: a JDetector

Definition at line 396 of file NBRun.hh.

                          {
   
     return detector ;
  
   }

◆ readBasicInfo()

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) ;
   
   }

◆ getRunNumber()

int NBRun::getRunNumber ( )

inline

Get run number.

Returns: run number

Definition at line 427 of file NBRun.hh.

                     {
  
     return run_number ;
  
   }

◆ getVoltage()

double NBRun::getVoltage ( )

inline

Get nanobeacon voltage.

Returns: nanobeacon voltage

Definition at line 439 of file NBRun.hh.

                      {
   
     return voltage ;
  
   }

Member Data Documentation

◆ topPMTs

vector<int> NBRun::topPMTs

private

Definition at line 26 of file NBRun.hh.

◆ bottomPMTs

vector<int> NBRun::bottomPMTs

private

Definition at line 26 of file NBRun.hh.

◆ srcPMTs

vector<int> NBRun::srcPMTs

private

Definition at line 26 of file NBRun.hh.

◆ tgtPMTs

vector<int> NBRun::tgtPMTs

private

Definition at line 26 of file NBRun.hh.

◆ nSuperModules

int NBRun::nSuperModules

private

Definition at line 28 of file NBRun.hh.

◆ max_distance

int NBRun::max_distance

private

Definition at line 30 of file NBRun.hh.

◆ string_number

int NBRun::string_number

private

Definition at line 32 of file NBRun.hh.

◆ filename

string NBRun::filename

private

Definition at line 34 of file NBRun.hh.

◆ run_number

int NBRun::run_number

private

Definition at line 36 of file NBRun.hh.

◆ voltage

double NBRun::voltage

private

Definition at line 38 of file NBRun.hh.

◆ detector

JDetector NBRun::detector

private

Definition at line 40 of file NBRun.hh.

◆ SuperMods

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

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ NBRun() [1/2]

◆ NBRun() [2/2]

◆ ~NBRun()

Member Function Documentation

◆ computeMeanToTs()

◆ find_good_couples()

◆ analyze()

◆ readFile()

◆ findSrcs()

◆ setSrcs()

◆ setRefs()

◆ findRefs()

◆ getSuperModules()

◆ setPMTs()

◆ initializeSuperModules()

◆ setDetector()

◆ getDetector()

◆ readBasicInfo()

◆ getRunNumber()

◆ getVoltage()

Member Data Documentation

◆ topPMTs

◆ bottomPMTs

◆ srcPMTs

◆ tgtPMTs

◆ nSuperModules

◆ max_distance

◆ string_number

◆ filename

◆ run_number

◆ voltage

◆ detector

◆ SuperMods