Regressor function object for JShower3EZ fit using JSimplex minimiser. More...

#include <JShower3EZRegressor.hh>

Inheritance diagram for JFIT::JRegressor< JShower3EZ, JSimplex >:

Public Types
typedef JTOOLS::JSplineFunction1S_t	JFunction1D_t

typedef JTOOLS::JMapList < JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList < JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList < JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JMapList < JTOOLS::JPolint0FunctionalGridMap > > > >	JPDFMaplist_t

typedef JPHYSICS::JPDFTable < JFunction1D_t, JPDFMaplist_t >	JPDF_t

typedef JTOOLS::JMapList < JTOOLS::JPolint1FunctionalMapH, JTOOLS::JMapList < JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList < JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JMapList < JTOOLS::JPolint0FunctionalGridMap > > > >	JNPEMaplist_t

typedef JPHYSICS::JNPETable < double, double, JNPEMaplist_t >	JNPE_t

typedef JSimplex< JShower3EZ >	minimiser_type

typedef JRegressor< JShower3EZ, JSimplex >	regressor_type

Public Member Functions
	JRegressor ()
	Default constructor. More...

	JRegressor (const std::string &fileDescriptor)
	Parameterized constructor. More...

double	operator() (const JShower3EZ &shower, const JPMTW0 &pmt) const
	Fit function. More...

JNPE_t::result_type	getH0 (const double R_Hz) const
	Get background hypothesis value for time integrated PDF. More...

JNPE_t::result_type	getH1 (const double D, const double cosDelta, const double theta, const double phi, const double E) const
	Get signal hypothesis value for time integrated PDF. More...

double	getRmax () const
	Get maximal road width of PDF. More...

double	operator() (const JShower3EZ &value, T __begin, T __end)
	Global fit. More...

double	operator() (const JShower3EZ &value, T1 __begin1, T1 __end1, T2 __begin2, T2 __end2)
	Global fit. More...

double	operator() (const JFunction_t &fit, T __begin, T __end)
	Multi-dimensional fit. More...

double	operator() (const JFunction_t &fit, T __begin, T __end, const JShower3EZ &step)
	1D fit. More...

Public Attributes
JPDF_t	pdf [NUMBER_OF_PDFS]
	PDF. More...

JNPE_t	npe [NUMBER_OF_PDFS]
	PDF. More...

JLANG::JSharedPointer < JMEstimator >	estimator
	M-Estimator function. More...

JShower3EZ	value

std::vector< JShower3EZ >	step

int	numberOfIterations

Static Public Attributes
static JTimeRange	T_ns
	Time window with respect to Cherenkov hypothesis [ns]. More...

static double	Vmax_npe = std::numeric_limits<double>::max()
	Maximal integral of PDF [npe]. More...

static const int	NUMBER_OF_PDFS = 1

static const JPDFType_t	pdf_t [NUMBER_OF_PDFS] = { DIRECT_LIGHT_FROM_EMSHOWER }
	PDF types. More...

static int	MAXIMUM_ITERATIONS
	maximal number of iterations More...

static double	EPSILON
	maximal distance to minimum More...

static int	debug = 0
	debug level (default is off). More...

Detailed Description

template<>
struct JFIT::JRegressor< JShower3EZ, JSimplex >

Regressor function object for JShower3EZ fit using JSimplex minimiser.

Definition at line 44 of file JShower3EZRegressor.hh.

Member Typedef Documentation

typedef JTOOLS::JSplineFunction1S_t JFIT::JRegressor< JShower3EZ, JSimplex >::JFunction1D_t

Definition at line 49 of file JShower3EZRegressor.hh.

typedef JTOOLS::JMapList<JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList<JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList<JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JMapList<JTOOLS::JPolint0FunctionalGridMap> > > > JFIT::JRegressor< JShower3EZ, JSimplex >::JPDFMaplist_t

Definition at line 53 of file JShower3EZRegressor.hh.

typedef JPHYSICS::JPDFTable<JFunction1D_t, JPDFMaplist_t> JFIT::JRegressor< JShower3EZ, JSimplex >::JPDF_t

Definition at line 54 of file JShower3EZRegressor.hh.

typedef JTOOLS::JMapList<JTOOLS::JPolint1FunctionalMapH, JTOOLS::JMapList<JTOOLS::JPolint1FunctionalMap, JTOOLS::JMapList<JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JMapList<JTOOLS::JPolint0FunctionalGridMap> > > > JFIT::JRegressor< JShower3EZ, JSimplex >::JNPEMaplist_t

Definition at line 59 of file JShower3EZRegressor.hh.

typedef JPHYSICS::JNPETable<double, double, JNPEMaplist_t> JFIT::JRegressor< JShower3EZ, JSimplex >::JNPE_t

Definition at line 60 of file JShower3EZRegressor.hh.

typedef JSimplex <JShower3EZ > JFIT::JAbstractRegressor< JShower3EZ , JSimplex >::minimiser_type

inherited

Definition at line 76 of file JRegressor.hh.

typedef JRegressor<JShower3EZ , JSimplex > JFIT::JAbstractRegressor< JShower3EZ , JSimplex >::regressor_type

inherited

Definition at line 77 of file JRegressor.hh.

Constructor & Destructor Documentation

JFIT::JRegressor< JShower3EZ, JSimplex >::JRegressor ( )

inline

Default constructor.

Definition at line 65 of file JShower3EZRegressor.hh.

66 {}

JFIT::JRegressor< JShower3EZ, JSimplex >::JRegressor ( const std::string & fileDescriptor )

inline

Parameterized constructor.

The PDF file descriptor should contain the wild card character JPHYSICS::WILD_CARD which will be replaced by the corresponding PDF types listed in JRegressor<JShower3Z, JGandalf>::pdf_t.

Parameters

fileDescriptor PDF file descriptor

Definition at line 77 of file JShower3EZRegressor.hh.

                                                :
       estimator(new JMEstimatorLorentzian())
     {
       using namespace std;
       using namespace JPHYSICS;
       
       const JPDF_t::JSupervisor supervisor(new JPDF_t::JDefaultResult(JMATH::zero));
       
       for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
         
         try {
             
           const string file_name = getFilename(fileDescriptor, pdf_t[i]);
             
           NOTICE("loading PDF from file " << file_name << "... " << flush);
 
           pdf[i].load(file_name.c_str());
           
           NOTICE("OK" << endl);
 
           pdf[i].setExceptionHandler(supervisor);
           
         }
         catch(const JException& error) {
           FATAL(error.what() << endl);
         }
       }
 
       // Add PDFs
       for (int i = 0; i < NUMBER_OF_PDFS; i++) {
         npe[ i ] = JNPE_t(pdf[i]);
       }
     
     }

Member Function Documentation

double JFIT::JRegressor< JShower3EZ, JSimplex >::operator()	(	const JShower3EZ &	shower,
		const JPMTW0 &	pmt
	)		const

inline

Fit function.

This method is used to determine the chi2 of given PMT with respect to shower hypothesis.

Parameters

shower	shower
pmt	pmt

Returns: chi2

Definition at line 120 of file JShower3EZRegressor.hh.

     {
       using namespace JGEOMETRY3D;
       using namespace JPHYSICS;
       
       JVector3D D(pmt.getPosition());
       JDirection3D U(pmt.getDirection());
 
       D.sub(shower.getPosition());
 
       const double z  = shower.getDirection().getDot(D);
       const double x  = D.getX()  -  z * shower.getDX();
       const double y  = D.getY()  -  z * shower.getDY();
       const double cosDelta = z/D.getLength();  // Delta = angle between shower direction and PMT position
  
       U.rotate(JRotation3Z(-atan2(y,x)));                  // rotate PMT axis to x-z plane
 
       const double theta = U.getTheta();
       const double phi   = fabs(U.getPhi());
 
       JNPE_t::result_type H0 = getH0(pmt.getR());  // getH0 = Get background hypothesis value for time integrated PDF. 
       JNPE_t::result_type H1 = getH1(D.getLength(), cosDelta, theta, phi, shower.getE());  // getH1 = Get signal hypothesis value for time integrated PDF. 
 
       if (H1.f >= Vmax_npe) {
         H1 *= Vmax_npe / H1.f;
       }
 
       H1 += H0; // now H1 is signal + background
 
       const bool hit = pmt.getN() != 0;
       const double u = H1.getChi2(hit); // -log(lik)
       
       return estimator->getRho(u);
     }

JNPE_t::result_type JFIT::JRegressor< JShower3EZ, JSimplex >::getH0 ( const double R_Hz ) const

inline

Get background hypothesis value for time integrated PDF.

Parameters

R_Hz rate [Hz]

Returns: hypothesis value

Definition at line 161 of file JShower3EZRegressor.hh.

     {
       return JNPE_t::result_type(R_Hz * 1e-9 * T_ns.getLength(), 0.0);
     }

JNPE_t::result_type JFIT::JRegressor< JShower3EZ, JSimplex >::getH1	(	const double	D,
		const double	cosDelta,
		const double	theta,
		const double	phi,
		const double	E
	)		const

inline

Get signal hypothesis value for time integrated PDF.

Parameters

D	PMT distance from shower [m]
cosDelta	angle between shower direction and PMT position
theta	PMT zenith angle [deg]
phi	PMT azimuth angle [deg]
E	shower energy [GeV]

Returns: hypothesis value

Definition at line 176 of file JShower3EZRegressor.hh.

     {
       JNPE_t::result_type h1 = JMATH::zero;
         
       for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
 
         if (!npe[i].empty() && D <= npe[i].getXmax()) {
 
           try {
 
             JNPE_t::result_type y1 = E * npe[i](std::max(D, npe[i].getXmin()), cosDelta, theta, phi);
           
             if (y1.f > 0.0) {
               h1 += y1;
             }
           
           }
           catch(JLANG::JException& error) {
             ERROR(error << std::endl);
           }
         }
       }
 
       return h1;
     }

double JFIT::JRegressor< JShower3EZ, JSimplex >::getRmax ( ) const

inline

Get maximal road width of PDF.

Returns: road width [m]

Definition at line 212 of file JShower3EZRegressor.hh.

     {
       double xmax = 0.0;
 
       for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
 
         if (!pdf[i].empty() && pdf[i].getXmax() > xmax) {
           xmax = pdf[i].getXmax();
         }
         
       }
 
       return xmax;
     }

double JFIT::JAbstractRegressor< JShower3EZ , JSimplex >::operator()	(	const JShower3EZ &	value,
		T	__begin,
		T	__end
	)

inlineinherited

Global fit.

Parameters

value	start value
__begin	begin of data set
__end	end of data set

Returns: chi2

Definition at line 89 of file JRegressor.hh.

     {
       static_cast<minimiser_type&>(*this).value = value;
 
       return static_cast<minimiser_type&>(*this)(static_cast<regressor_type&>(*this), __begin, __end);
     }

double JFIT::JAbstractRegressor< JShower3EZ , JSimplex >::operator()	(	const JShower3EZ &	value,
		T1	__begin1,
		T1	__end1,
		T2	__begin2,
		T2	__end2
	)

inlineinherited

Global fit.

Parameters

value	start value
__begin1	begin of first data set
__end1	end of first data set
__begin2	begin of second data set
__end2	end of second data set

Returns: chi2

Definition at line 108 of file JRegressor.hh.

     {
       static_cast<minimiser_type&>(*this).value = value;
 
       return static_cast<minimiser_type&>(*this)(static_cast<regressor_type&>(*this), __begin1, __end1, __begin2, __end2);
     }

double JFIT::JSimplex< JShower3EZ >::operator()	(	const JFunction_t &	fit,
		T	__begin,
		T	__end
	)

inlineinherited

Multi-dimensional fit.

The given fit function should return the equivalent of chi2 for the current value of the given model and a given data point.

Parameters

fit	fit function
__begin	begin of data
__end	end of data

Returns: chi2

Definition at line 69 of file JSimplex.hh.

     {
       using namespace std;
       using namespace JPP;
 
       double chi2_old = evaluate(fit, __begin, __end);
 
       const int N = step.size();
 
       if (N != 0) {
 
         double chi2[N];
 
         numberOfIterations = 0;
 
         while (numberOfIterations != MAXIMUM_ITERATIONS) {
 
           DEBUG("old: " << FIXED(12,5) << chi2_old << endl);
 
           const JModel_t p0(value);
 
           for (int i = 0; i != N; ++i) {
 
             DEBUG("step: " << i << ' ' << setw(5) << numberOfIterations << endl);
 
             chi2[i] = (*this)(fit, __begin, __end, step[i]);
           }
 
           // overall step direction of last iteration
 
           JModel_t wall = value - p0;
 
           const double chi2_new = (*this)(fit, __begin, __end, wall);
 
           DEBUG("new: " << FIXED(12,5) << chi2_new << endl);
 
 
           if (fabs(chi2_old - chi2_new) < EPSILON*fabs(chi2_old)) {
             return chi2_new;
           }
 
           // double overall step
 
           wall   = value - p0;
 
           value += wall;
 
           const double fe = evaluate(fit, __begin, __end);
 
           value -= wall;
 
 
           for (int i = N-1; i != 0; --i) {
             chi2[i] = chi2[i-1] - chi2[i];
           }
 
           chi2[0] = chi2_old - chi2[0];
 
 
           double df = 0.0;
 
           for (int i = 0; i != N; ++i) {
             if (chi2[i] > df) {
               df = chi2[i];
             }
           }
 
           const double fn = chi2_new;
           const double f0 = chi2_old;
           const double ff = f0 - fn - df;
 
           // shift step directions
 
           if (fe < f0 && 2.0*(f0 - 2.0*fn + fe)*ff*ff < (f0-fe)*(f0-fe)*df) {
 
             for (int i = 0; i != N - 1; ++i) {
               step[i] = step[i+1];
             }
 
             step[N-1] = wall;
           }
 
           chi2_old = chi2_new;
         }
       }
 
       return chi2_old;
     }

double JFIT::JSimplex< JShower3EZ >::operator()	(	const JFunction_t &	fit,
		T	__begin,
		T	__end,
		const JShower3EZ &	step
	)

inlineinherited

1D fit.

The given fit function should return the equivalent of chi2 for the current value of the given model and a given data point.

Parameters

fit	fit function
__begin	begin of data
__end	end of data
step	step direction

Definition at line 171 of file JSimplex.hh.

     {
       using namespace std;
       using namespace JPP;
 
       double lambda = 0.5;                                     // control parameter
       double factor = 1.0;                                     // multiplication factor
 
       double chi2_old = evaluate(fit, __begin, __end);
 
       for (int i = 0; numberOfIterations != MAXIMUM_ITERATIONS; ++numberOfIterations, ++i) {
 
         value += lambda * step;
 
         const double chi2_new = evaluate(fit, __begin, __end);
 
         DEBUG("step: " << setw(3) << i << ' ' << FIXED(12,5) << chi2_old << ' ' << FIXED(12,5) << chi2_new << ' ' << FIXED(5,2) << lambda << endl);
 
         if (fabs(chi2_old - chi2_new) < EPSILON*fabs(chi2_old)) {
 
           if (chi2_new > chi2_old) {
 
             value -= lambda * step;                            // undo last step
 
             return chi2_old;
 
           } else {
 
             return chi2_new;
           }
         }
 
         if (chi2_new < chi2_old) {
 
           chi2_old = chi2_new;
 
         } else {
             
           value  -=  lambda * step;                            // step back
           lambda  = -lambda;                                   // change direction
           
           if (i != 0) {
             factor = 0.5;                                      // reduce step size
           }
         }
         
         lambda = factor * lambda;
       }
 
       return chi2_old;
     }

Member Data Documentation

JTimeRange JFIT::JRegressor< JShower3EZ, JSimplex >::T_ns

static

Time window with respect to Cherenkov hypothesis [ns].

Default values.

Definition at line 228 of file JShower3EZRegressor.hh.

double JFIT::JRegressor< JShower3EZ, JSimplex >::Vmax_npe = std::numeric_limits<double>::max()

static

Maximal integral of PDF [npe].

Definition at line 229 of file JShower3EZRegressor.hh.

const int JFIT::JRegressor< JShower3EZ, JSimplex >::NUMBER_OF_PDFS = 1

static

Definition at line 231 of file JShower3EZRegressor.hh.

const JPDFType_t JFIT::JRegressor< JShower3EZ, JSimplex >::pdf_t = { DIRECT_LIGHT_FROM_EMSHOWER }

static

PDF types.

Definition at line 233 of file JShower3EZRegressor.hh.

JPDF_t JFIT::JRegressor< JShower3EZ, JSimplex >::pdf[NUMBER_OF_PDFS]

PDF.

Definition at line 235 of file JShower3EZRegressor.hh.

JNPE_t JFIT::JRegressor< JShower3EZ, JSimplex >::npe[NUMBER_OF_PDFS]

PDF.

Definition at line 236 of file JShower3EZRegressor.hh.

JLANG::JSharedPointer<JMEstimator> JFIT::JRegressor< JShower3EZ, JSimplex >::estimator

M-Estimator function.

Definition at line 238 of file JShower3EZRegressor.hh.

int JFIT::JSimplex< JShower3EZ >::MAXIMUM_ITERATIONS

staticinherited

maximal number of iterations

maximal number of iterations.

Definition at line 224 of file JSimplex.hh.

double JFIT::JSimplex< JShower3EZ >::EPSILON

staticinherited

maximal distance to minimum

maximal distance to minimum.

Definition at line 225 of file JSimplex.hh.

JShower3EZ JFIT::JSimplex< JShower3EZ >::value

inherited

Definition at line 227 of file JSimplex.hh.

std::vector<JShower3EZ > JFIT::JSimplex< JShower3EZ >::step

inherited

Definition at line 228 of file JSimplex.hh.

int JFIT::JSimplex< JShower3EZ >::numberOfIterations

inherited

Definition at line 229 of file JSimplex.hh.

template<class T>

int JEEP::JMessage< T >::debug = 0

staticinherited

debug level (default is off).

Definition at line 43 of file JMessage.hh.

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

JShower3EZRegressor.hh

Public Types

Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

template<> struct JFIT::JRegressor< JShower3EZ, JSimplex >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<>
struct JFIT::JRegressor< JShower3EZ, JSimplex >