---

SiPixelTemplate.h

Go to the documentation of this file.

//
//  SiPixelTemplate.h (v5.00)
//
//  Add goodness-of-fit info and spare entries to templates, version number in template header, more error checking
//  Add correction for (Q_F-Q_L)/(Q_F+Q_L) bias
//  Add cot(beta) reflection to reduce y-entries and more sophisticated x-interpolation
//  Fix small index searching bug in interpolate method
//  Change interpolation indexing to avoid complier complaining about possible un-initialized variables
//  Replace containers with static arrays in calls to ysigma2 and xsigma2
//  Add external threshold to calls to ysigma2 and xsigma2, fix parameter signal max for xsigma2
//  Return to 5 pixel spanning but adjust boundaries to use only when needed
//  Implement improved (faster) chi2min search that depends on pixel types
//  Fill template arrays in single calls to this object
//  Add qmin to the template
//  Add qscale to match charge scales
//  Small improvement to x-chisquare interpolation
//  Enlarge SiPixelTemplateStore to accommodate larger templates and increased alpha acceptance (reduce PT threshold to ~200 MeV)
//  Store x and y cluster sizes in fractional pixels to facilitate cluster splitting
//  Keep interpolated central 9 template bins in private storage and expand/shift in the getter functions (faster for speed=2/3) and easier to build 3d templates
//  Store error and bias information for the simple chi^2 min position analysis (no interpolation or Q_{FB} corrections) to use in cluster splitting
//  To save time, the gaussian centers and sigma are not interpolated right now (they aren't currently used).  They can be restored by un-commenting lines in the interpolate method.
//  Add a new method to calculate qbin for input cotbeta and cluster charge.  To be used for error estimation of merged clusters in PixelCPEGeneric.
//  Add bias info for Barrel and FPix separately in the header
//  Improve the charge estimation for larger cot(alpha) tracks
//  Change interpolate method to return false boolean if track angles are outside of range
//  Add template info and method for truncation information
//  Change to allow template sizes to be changed at compile time
//
// Created by Morris Swartz on 10/27/06.
// Copyright 2006 __TheJohnsHopkinsUniversity__. All rights reserved.
//
//
 
// Build the template storage structure from several pieces 

#ifndef SiPixelTemplate_h
#define SiPixelTemplate_h 1

#define TYSIZE 21
#define TYTEN 210 // = 10*TYSIZE
#define BYSIZE TYSIZE+4
#define BHY 12 // = BYSIZE/2
#define BYM1 TYSIZE+3
#define BYM2 TYSIZE+2
#define BYM3 TYSIZE+1
#define TXSIZE 13
#define BXSIZE TXSIZE+4
#define BHX 8 // = BXSIZE/2
#define BXM1 TXSIZE+3
#define BXM2 TXSIZE+2
#define BXM3 TXSIZE+1

#include<vector>
#include<cassert>
#include "boost/multi_array.hpp"

typedef boost::multi_array<float, 3> array_3d;

struct SiPixelTemplateEntry { 
  int runnum;              
  float alpha;             
  float cotalpha;          
  float beta;              
  float cotbeta;           
  float costrk[3];            
  float qavg;              
  float pixmax;            
  float symax;             
  float dyone;             
  float syone;             
  float sxmax;             
  float dxone;             
  float sxone;             
  float dytwo;             
  float sytwo;             
  float dxtwo;             
  float sxtwo;             
  float qmin;              
  float clsleny;           
  float clslenx;           
  float ypar[2][5];        
  float ytemp[9][TYSIZE];  
  float xpar[2][5];        
  float xtemp[9][TXSIZE];  
  float yavg[4];           
  float yrms[4];           
  float ygx0[4];           
  float ygsig[4];          
  float yflpar[4][6];      
  float xavg[4];           
  float xrms[4];           
  float xgx0[4];           
  float xgsig[4];          
  float xflpar[4][6];      
  float chi2yavg[4];       
  float chi2ymin[4];       
  float chi2xavg[4];       
  float chi2xmin[4];       
  float yavgc2m[4];        
  float yrmsc2m[4];        
  float ygx0c2m[4];        
  float ygsigc2m[4];       
  float xavgc2m[4];        
  float xrmsc2m[4];        
  float xgx0c2m[4];        
  float xgsigc2m[4];       
  float yspare[10];       
  float xspare[10];       
} ;




struct SiPixelTemplateHeader {           
  char title[80];         
  int ID;                 
  int NBy;                
  int NByx;               
  int NBxx;               
  int NFy;                
  int NFyx;               
  int NFxx;               
  float Bbias;            
  float Fbias;            
  float temperature;      
  float fluence;          
  float qscale;           
  float s50;              
  int templ_version;      
} ;





struct SiPixelTemplateStore { 
  SiPixelTemplateHeader head;
  SiPixelTemplateEntry entby[60];     
  SiPixelTemplateEntry entbx[5][29];  
  SiPixelTemplateEntry entfy[16];     
  SiPixelTemplateEntry entfx[3][29];   
} ;





// ******************************************************************************************
// ******************************************************************************************
class SiPixelTemplate {
 public:
  SiPixelTemplate() {id_current = -1; index_id = -1; cota_current = 0.; cotb_current = 0.; fpix_current=false;} 
  bool pushfile(int filenum);     // load the private store with info from the 
                                  // file with the index (int) filenum
  
  // Interpolate input alpha and beta angles to produce a working template for each individual hit. 
  bool interpolate(int id, bool fpix, float cotalpha, float cotbeta);
  
  // retreive interpolated templates. 
  void ytemp(int fybin, int lybin, float ytemplate[41][BYSIZE]);
  
  void xtemp(int fxbin, int fxbin, float xtemplate[41][BXSIZE]);
  
  // new methods to build templates from two interpolated clusters (for splitting) 
  void ytemp3d(int nypix, array_3d& ytemplate);
  
  void xtemp3d(int nxpix, array_3d& xtemplate);
  
  // Convert vector of projected signals into uncertainties for fitting. 
  void ysigma2(int fypix, int lypix, float sythr, float ysum[BYSIZE], float ysig2[BYSIZE]);
  
  void xsigma2(int fxpix, int lxpix, float sxthr, float xsum[BXSIZE], float xsig2[BXSIZE]);
  
  // Interpolate qfl correction in y. 
  float yflcorr(int binq, float qfly);
  
  // Interpolate qfl correction in x. 
  float xflcorr(int binq, float qflx);
  
  // Interpolate input beta angle to estimate the average charge and return qbin flag for input cluster charge. 
  int qbin(int id, bool fpix, float cotbeta, float qclus);
  
  float qavg() {return pqavg;}        
  float pixmax() {return ppixmax;}         
  float qscale() {return pqscale;}         
  float s50() {return ps50;}               
  float symax() {return psymax;}             
  float dyone() {return pdyone;}             
  float syone() {return psyone;}             
  float dytwo() {return pdytwo;}             
  float sytwo() {return psytwo;}            
  float sxmax() {return psxmax;}            
  float dxone() {return pdxone;}             
  float sxone() {return psxone;}             
  float dxtwo() {return pdxtwo;}             
  float sxtwo() {return psxtwo;}             
  float qmin() {return pqmin;}               
  float clsleny() {return pclsleny;}         
  float clslenx() {return pclslenx;}         
  float yratio() {return pyratio;}            
  float yxratio() {return pyxratio;}           
  float xxratio() {return pxxratio;}           
  float yavg(int i) {assert(i>=0 && i<4); return pyavg[i];}         
  float yrms(int i) {assert(i>=0 && i<4); return pyrms[i];}         
  float ygx0(int i) {assert(i>=0 && i<4); return pygx0[i];}         
  float ygsig(int i) {assert(i>=0 && i<4); return pygsig[i];}       
  float xavg(int i) {assert(i>=0 && i<4); return pxavg[i];}         
  float xrms(int i) {assert(i>=0 && i<4); return pxrms[i];}         
  float xgx0(int i) {assert(i>=0 && i<4); return pxgx0[i];}         
  float xgsig(int i) {assert(i>=0 && i<4); return pxgsig[i];}       
  float chi2yavg(int i) {assert(i>=0 && i<4); return pchi2yavg[i];} 
  float chi2ymin(int i) {assert(i>=0 && i<4); return pchi2ymin[i];} 
  float chi2xavg(int i) {assert(i>=0 && i<4); return pchi2xavg[i];} 
  float chi2xmin(int i) {assert(i>=0 && i<4); return pchi2xmin[i];} 
  float yavgc2m(int i) {assert(i>=0 && i<4); return pyavgc2m[i];}   
  float yrmsc2m(int i) {assert(i>=0 && i<4); return pyrmsc2m[i];}   
  float ygx0c2m(int i) {assert(i>=0 && i<4); return pygx0c2m[i];}   
  float ygsigc2m(int i) {assert(i>=0 && i<4); return pygsigc2m[i];} 
  float xavgc2m(int i) {assert(i>=0 && i<4); return pxavgc2m[i];}   
  float xrmsc2m(int i) {assert(i>=0 && i<4); return pxrmsc2m[i];}   
  float xgx0c2m(int i) {assert(i>=0 && i<4); return pxgx0c2m[i];}   
  float xgsigc2m(int i) {assert(i>=0 && i<4); return pxgsigc2m[i];} 
//  float yspare(int i) {assert(i>=0 && i<10); return pyspare[i];}    //!< vector of 10 spares interpolated in beta only
//  float xspare(int i) {assert(i>=0 && i<10); return pxspare[i];}    //!< vector of 10 spares interpolated in alpha and beta
  
  
 private:
  
  // Keep current template interpolaion parameters      
  
  int id_current;           
  int index_id;             
  float cota_current;       
  float cotb_current;       
  float abs_cotb;           
  bool fpix_current;        
  
  
  // Keep results of last interpolation to return through member functions
  
  float pqavg;              
  float ppixmax;            
  float pqscale;            
  float ps50;               
  float psymax;             
  float psyparmax;          
  float pdyone;             
  float psyone;             
  float pdytwo;             
  float psytwo;             
  float psxmax;             
  float psxparmax;          
  float pdxone;             
  float psxone;             
  float pdxtwo;             
  float psxtwo;             
  float pqmin;              
  float pclsleny;           
  float pclslenx;           
  float pyratio;            
  float pyparl[2][5];       
  float pyparh[2][5];       
  float pxparly0[2][5];     
  float pxparhy0[2][5];     
  float pytemp[9][BYSIZE];  
  float pyxratio;           
  float pxxratio;           
  float pxpar0[2][5];       
  float pxparl[2][5];       
  float pxparh[2][5];       
  float pxtemp[9][BXSIZE];  
  float pyavg[4];           
  float pyrms[4];           
  float pygx0[4];           
  float pygsig[4];          
  float pyflparl[4][6];     
  float pyflparh[4][6];     
  float pxavg[4];           
  float pxrms[4];           
  float pxgx0[4];           
  float pxgsig[4];           
  float pxflparll[4][6];    
  float pxflparlh[4][6];    
  float pxflparhl[4][6];    
  float pxflparhh[4][6];    
  float pchi2yavg[4];       
  float pchi2ymin[4];       
  float pchi2xavg[4];       
  float pchi2xmin[4];       
  float pyavgc2m[4];        
  float pyrmsc2m[4];        
  float pygx0c2m[4];        
  float pygsigc2m[4];       
  float pxavgc2m[4];        
  float pxrmsc2m[4];        
  float pxgx0c2m[4];        
  float pxgsigc2m[4];       
  float pyspare[10];        
  float pxspare[10];        
  
  // The actual template store is a std::vector container

  std::vector< SiPixelTemplateStore > thePixelTemp;
} ;


#endif

---