JFIT::JRegressor< JLine3Z, JGandalf > Struct Reference

Regressor function object for JLine3Z fit using JGandalf minimiser. More...

#include <JLine3ZRegressor.hh>

Inheritance diagram for JFIT::JRegressor< JLine3Z, JGandalf >:

Public Types
typedef JRegressorStorage< JLine3Z, JGandalf >	JRegressorStorage_t
typedef JGandalf< JLine3Z >	minimiser_type
typedef JRegressor< JLine3Z, JGandalf >	regressor_type
typedef minimiser_type::result_type	result_type
typedef JFIT_LOCAL::JTypedef_t< JModel_t >::parameter_type	parameter_type
	Data type of fit parameter. More...
typedef JTOOLS::JSplineFunction1S_t	JFunction1D_t
typedef JTOOLS::JMAPLIST< JTOOLS::JPolint1FunctionalMap, JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JPolint0FunctionalGridMap >::maplist	JPDFMaplist_t
typedef JPHYSICS::JPDFTable< JFunction1D_t, JPDFMaplist_t >	JPDF_t
	time dependent PDF More...
typedef JTOOLS::JMAPLIST< JTOOLS::JPolint1FunctionalMapH, JTOOLS::JPolint1FunctionalGridMap, JTOOLS::JPolint1FunctionalGridMap >::maplist	JNPEMaplist_t
typedef JPHYSICS::JNPETable< double, double, JNPEMaplist_t >	JNPE_t
	time integrated PDF More...
typedef JPDF_t::transformer_type	transformer_type
typedef std::array< JPDF_t, NUMBER_OF_PDFS >	JPDFs_t
	PDFs. More...
typedef std::array< JNPE_t, NUMBER_OF_PDFS >	JNPEs_t
	NPEs. More...

Public Member Functions
	JRegressor ()
	Default constructor. More...
	JRegressor (const std::string &fileDescriptor, const double TTS, const int numberOfPoints=25, const double epsilon=1.0e-10)
	Constructor. More...
	JRegressor (const JRegressorStorage< JLine3Z, JGandalf > &storage)
	Constructor. More...
template<class JHit_t >
result_type	operator() (const JLine3Z &track, const JHit_t &hit) const
	Fit function. More...
result_type	operator() (const JLine3Z &track, const JPMTW0 &pmt) const
	Fit function. More...
JPDF_t::result_type	getH0 (const double R_Hz, const double t1) const
	Get background hypothesis value for time differentiated PDF. More...
JPDF_t::result_type	getH1 (const double E, const double R, const double theta, const double phi, const double t1) const
	Get signal hypothesis value for time differentiated PDF. 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 E, const double R, const double theta, const double phi) const
	Get signal hypothesis value for time integrated PDF. More...
double	getRmax () const
	Get maximal road width of PDF. More...
result_type	operator() (const JLine3Z &value, T __begin, T __end)
	Global fit. More...
template<class JFunction_t , class T , class ... Args>
result_type	operator() (const JFunction_t &fit, T __begin, T __end, Args ...args)
	Multi-dimensional fit of multiple data sets. More...
const JPDFs_t &	getPDF () const
	Get PDFs. More...
const JNPEs_t &	getNPE () const
	Get NPEs. More...
void	transform (const transformer_type &transformer)
	Transform PDFs and NPEs. More...
void	setRmax (const double Rmax)
	Set maximal road width of PDF. More...

Public Attributes
const JPDFs_t &	pdf
	PDF. More...
const JNPEs_t &	npe
	PDF. More...
double	E_GeV = 0.0
	Energy of muon at vertex [GeV]. More...
JLANG::JSharedPointer< JMEstimator >	estimator = new JMEstimatorNormal()
	M-Estimator function. More...
std::vector< parameter_type >	parameters
	fit parameters More...
int	numberOfIterations
	number of iterations More...
double	lambda
	control parameter More...
JModel_t	value
	value More...
JModel_t	error
	error More...
JMATH::JMatrixNS	V
	Hesse matrix. More...

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 double	Rmin_m = 0.1
	Minimal distance of [m]. More...
static int	MAXIMUM_ITERATIONS = 1000
	maximal number of iterations More...
static double	EPSILON = 1.0e-3
	maximal distance to minimum More...
static bool	EPSILON_ABSOLUTE = false
	set epsilon to absolute difference instead of relative More...
static double	LAMBDA_MIN = 0.01
	minimal value control parameter More...
static double	LAMBDA_MAX = 100.0
	maximal value control parameter More...
static double	LAMBDA_UP = 10.0
	multiplication factor control parameter More...
static double	LAMBDA_DOWN = 10.0
	multiplication factor control parameter More...
static double	PIVOT = std::numeric_limits<double>::epsilon()
	minimal value diagonal element of Hesse matrix More...
static int	debug = 0
	debug level (default is off). More...
static const int	NUMBER_OF_PDFS = 6
	Number of PDFs. More...
static const JPDFType_t	pdf_t [NUMBER_OF_PDFS]
	PDF types. More...

Private Member Functions
void	reset ()
	Reset current parameters. More...
template<class JFunction_t , class T , class ... Args>
void	update (const JFunction_t &fit, T __begin, T __end, Args ...args)
	Recursive method to update current parameters. More...
template<class JFunction_t >
void	update (const JFunction_t &fit)
	Termination method to update current parameters. More...

Static Private Member Functions
static double	get (const JModel_t &model, double JModel_t::*parameter)
	Read/write access to parameter value by data member. More...
static double &	get (JModel_t &model, double JModel_t::*parameter)
	Read/write access to parameter value by data member. More...
static double	get (const JModel_t &model, const size_t index)
	Read/write access to parameter value by index. More...
static double &	get (JModel_t &model, const size_t index)
	Read/write access to parameter value by index. More...
static double	get (const JModel_t &model, const int index)
	Read/write access to parameter value by index. More...
static double &	get (JModel_t &model, const int index)
	Read/write access to parameter value by index. More...

Private Attributes
std::vector< double >	h
JMATH::JVectorND	x
struct {
result_type   result
}	current
struct {
JModel_t   value
result_type   result
}	previous
JPDFs_t	_pdf
	PDFs. More...
JNPEs_t	_npe
	NPEs. More...

Detailed Description

Regressor function object for JLine3Z fit using JGandalf minimiser.

Definition at line 103 of file JLine3ZRegressor.hh.

Member Typedef Documentation

JRegressorStorage_t

typedef JRegressorStorage<JLine3Z, JGandalf> JFIT::JRegressor< JLine3Z, JGandalf >::JRegressorStorage_t

Definition at line 109 of file JLine3ZRegressor.hh.

minimiser_type

typedef JGandalf <JLine3Z > JFIT::JAbstractRegressor< JLine3Z , JGandalf >::minimiser_type

inherited

Definition at line 80 of file JRegressor.hh.

regressor_type

typedef JRegressor<JLine3Z , JGandalf > JFIT::JAbstractRegressor< JLine3Z , JGandalf >::regressor_type

inherited

Definition at line 81 of file JRegressor.hh.

result_type

typedef minimiser_type::result_type JFIT::JAbstractRegressor< JLine3Z , JGandalf >::result_type

inherited

Definition at line 82 of file JRegressor.hh.

parameter_type

template<class JModel_t >

typedef JFIT_LOCAL::JTypedef_t<JModel_t>::parameter_type JFIT::JGandalf< JModel_t >::parameter_type

inherited

Data type of fit parameter.

Definition at line 95 of file JGandalf.hh.

JFunction1D_t

typedef JTOOLS::JSplineFunction1S_t JFIT::JRegressorHelper< JLine3Z, JGandalf >::JFunction1D_t

inherited

Definition at line 57 of file JRegressorHelper.hh.

JPDFMaplist_t

typedef JTOOLS::JMAPLIST<JTOOLS::JPolint1FunctionalMap, JTOOLS::JPolint0FunctionalGridMap, JTOOLS::JPolint0FunctionalGridMap>::maplist JFIT::JRegressorHelper< JLine3Z, JGandalf >::JPDFMaplist_t

inherited

Definition at line 60 of file JRegressorHelper.hh.

JPDF_t

typedef JPHYSICS::JPDFTable<JFunction1D_t, JPDFMaplist_t> JFIT::JRegressorHelper< JLine3Z, JGandalf >::JPDF_t

inherited

time dependent PDF

Definition at line 61 of file JRegressorHelper.hh.

JNPEMaplist_t

typedef JTOOLS::JMAPLIST<JTOOLS::JPolint1FunctionalMapH, JTOOLS::JPolint1FunctionalGridMap, JTOOLS::JPolint1FunctionalGridMap>::maplist JFIT::JRegressorHelper< JLine3Z, JGandalf >::JNPEMaplist_t

inherited

Definition at line 65 of file JRegressorHelper.hh.

JNPE_t

typedef JPHYSICS::JNPETable<double, double, JNPEMaplist_t> JFIT::JRegressorHelper< JLine3Z, JGandalf >::JNPE_t

inherited

time integrated PDF

Definition at line 66 of file JRegressorHelper.hh.

transformer_type

typedef JPDF_t::transformer_type JFIT::JRegressorHelper< JLine3Z, JGandalf >::transformer_type

inherited

Definition at line 68 of file JRegressorHelper.hh.

JPDFs_t

typedef std::array<JPDF_t, NUMBER_OF_PDFS> JFIT::JRegressorHelper< JLine3Z, JGandalf >::JPDFs_t

inherited

PDFs.

Definition at line 72 of file JRegressorHelper.hh.

JNPEs_t

typedef std::array<JNPE_t, NUMBER_OF_PDFS> JFIT::JRegressorHelper< JLine3Z, JGandalf >::JNPEs_t

inherited

NPEs.

Definition at line 73 of file JRegressorHelper.hh.

Constructor & Destructor Documentation

JRegressor() [1/3]

JFIT::JRegressor< JLine3Z, JGandalf >::JRegressor ( )

inline

Default constructor.

Definition at line 114 of file JLine3ZRegressor.hh.

                 :
      JRegressorStorage_t(),
      pdf(getPDF()),
      npe(getNPE())
    {}

JRegressor() [2/3]

JFIT::JRegressor< JLine3Z, JGandalf >::JRegressor ( const std::string &  fileDescriptor, const double  TTS, const int  numberOfPoints = 25, const double  epsilon = 1.0e-10  )

inline

Constructor.

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

The TTS corresponds to the additional time smearing applied to the PDFs.

Parameters

fileDescriptor	PDF file descriptor
TTS	TTS [ns]
numberOfPoints	number of points for Gauss-Hermite integration of TTS
epsilon	precision for Gauss-Hermite integration of TTS

Definition at line 134 of file JLine3ZRegressor.hh.

                                                            :
      JRegressorStorage_t(fileDescriptor, TTS, numberOfPoints, epsilon),
      pdf(getPDF()),
      npe(getNPE())
    {}

JRegressor() [3/3]

JFIT::JRegressor< JLine3Z, JGandalf >::JRegressor ( const JRegressorStorage< JLine3Z, JGandalf > &  storage )

inline

Constructor.

Parameters

storage

PDF storage

Definition at line 149 of file JLine3ZRegressor.hh.

                                                                    :
      pdf(storage.getPDF()),
      npe(storage.getNPE())
    {}

Member Function Documentation

operator()() [1/4]

template<class JHit_t >

result_type JFIT::JRegressor< JLine3Z, JGandalf >::operator() ( const JLine3Z &  track, const JHit_t &  hit  ) const

inline

Fit function.

This method is used to determine the chi2 and gradient of given hit with respect to trajectory of muon.

The template argument JHit_t refers to a data structure which should have the following member methods:

• double getX(); // [m]
• double getY(); // [m]
• double getZ(); // [m]
• double getDX(); // [u]
• double getDY(); // [u]
• double getDZ(); // [u]
• double getT(); // [ns]

Parameters

track	track
hit	hit

Returns

chi2 and gradient

Definition at line 173 of file JLine3ZRegressor.hh.

    {
      using namespace JPP;
      
      JPosition3D  D(hit.getX(),  hit.getY(),  hit.getZ());
      JDirection3D U(hit.getDX(), hit.getDY(), hit.getDZ());
 
      D.sub(track.getPosition());
 
      const double z  = D.getDot(track.getDirection());
      const double x  = D.getX()  -  z * track.getDX();
      const double y  = D.getY()  -  z * track.getDY();
      const double R2 = D.getLengthSquared() - z*z;
      const double R  = (R2 > Rmin_m*Rmin_m ? sqrt(R2) : Rmin_m);
 
      const double t1 = track.getT() + (z + R * getTanThetaC()) * getInverseSpeedOfLight();
 
      U.rotate(JRotation3Z(-atan2(y,x)));                  // rotate PMT axis to x-z plane
 
      const double theta = U.getTheta();
      const double phi   = fabs(U.getPhi());
 
      const double E  = gWater.getE(E_GeV, z);
      const double dt = T_ns.constrain(hit.getT()  -  t1);
 
      JPDF_t::result_type H0 = getH0(hit.getR(), dt);
      JPDF_t::result_type H1 = getH1(E, R, theta, phi, dt);
 
      if (H1.V >= Vmax_npe) {
        H1 *= Vmax_npe / H1.V;
      }
 
      H1 += H0;                                                                                      // signal + background
 
      result_type result;
 
      result.chi2     = H1.getChi2() - H0.getChi2();                                                 // Likelihood ratio
 
      const double wc = 1.0  -  getTanThetaC() * z / R;                                              // d(ct1)/d(z)
 
      result.gradient = JLine3Z(JLine1Z(JPosition3D(-getTanThetaC() * D.getX() / R,                  // d(ct1)/d(x)
                                                    -getTanThetaC() * D.getY() / R,                  // d(ct1)/d(y)
                                                    0.0),
                                        getSpeedOfLight()),                                          // d(ct1)/d(t)
                                JVersor3Z(wc * (D.getX() - D.getZ()*track.getDX()/track.getDZ()),    // d(ct1)/d(dx)
                                          wc * (D.getY() - D.getZ()*track.getDY()/track.getDZ())));  // d(ct1)/d(dy)
      
      result.gradient.mul(getInverseSpeedOfLight() * (H1.getDerivativeOfChi2() -
                                                      H0.getDerivativeOfChi2()));                    // x d(chi2)/d(ct1)
 
      return result;
    }

operator()() [2/4]

result_type JFIT::JRegressor< JLine3Z, JGandalf >::operator() ( const JLine3Z &  track, const JPMTW0 &  pmt  ) const

inline

Fit function.

This method is used to determine the chi2 and gradient of given PMT with respect to trajectory of muon.

Parameters

track	track
pmt	pmt

Returns

chi2 and gradient

Definition at line 235 of file JLine3ZRegressor.hh.

    {
      using namespace JGEOMETRY3D;
      using namespace JPHYSICS;
      
      JPosition3D  D(pmt.getPosition());
      JDirection3D U(pmt.getDirection());
 
      D.sub(track.getPosition());
 
      const double z  = D.getDot(track.getDirection());
      const double x  = D.getX()  -  z * track.getDX();
      const double y  = D.getY()  -  z * track.getDY();
      const double R2 = D.getLengthSquared() - z*z;
      const double R  = (R2 > Rmin_m*Rmin_m ? sqrt(R2) : Rmin_m);
 
      U.rotate(JRotation3Z(-atan2(y,x)));                  // rotate PMT axis to x-z plane
 
      const double theta = U.getTheta();
      const double phi   = fabs(U.getPhi());
 
      const double E  = gWater.getE(E_GeV, z);
 
      JNPE_t::result_type H0 = getH0(pmt.getR());
      JNPE_t::result_type H1 = getH1(E, R, theta, phi);
 
      if (H1.f >= Vmax_npe) {
        H1 *= Vmax_npe / H1.f;
      }
 
      H1 += H0;
 
      const bool   hit = pmt.getN() != 0;
      const double u   = H1.getChi2(hit);
 
      result_type result;
 
      result.chi2     = estimator->getRho(u);
 
      result.gradient = JLine3Z(JLine1Z(JPosition3D(-D.getX() / R,   // d(R)/d(x)
                                                    -D.getY() / R,   // d(R)/d(y)
                                                    0.0),
                                        0.0),
                                JVersor3Z(-z * D.getX() / R,         // d(R)/d(dx)
                                          -z * D.getY() / R));       // d(R)/d(dy)
 
      result.gradient.mul(estimator->getPsi(u));
      result.gradient.mul(H1.getDerivativeOfChi2(hit));              // x d(chi2)/d(R)
 
      return result;
    }

getH0() [1/2]

JPDF_t::result_type JFIT::JRegressor< JLine3Z, JGandalf >::getH0 ( const double  R_Hz, const double  t1  ) const

inline

Get background hypothesis value for time differentiated PDF.

Parameters

R_Hz	rate [Hz]
t1	time [ns]

Returns

hypothesis value

Definition at line 295 of file JLine3ZRegressor.hh.

    {
      return JPDF_t::result_type(R_Hz * 1e-9, t1, T_ns);
    }

getH1() [1/2]

JPDF_t::result_type JFIT::JRegressor< JLine3Z, JGandalf >::getH1 ( const double  E, const double  R, const double  theta, const double  phi, const double  t1  ) const

inline

Get signal hypothesis value for time differentiated PDF.

Parameters

E	muon energy at minimum distance of approach [GeV]
R	minimum distance of approach [m]
theta	PMT zenith angle [rad]
phi	PMT azimuth angle [rad]
t1	arrival time relative to Cherenkov hypothesis [ns]

Returns

hypothesis value

Definition at line 312 of file JLine3ZRegressor.hh.

    {
      using namespace std;
      using namespace JPP;
 
      JPDF_t::result_type h1 = zero;
 
      for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
 
        if (!pdf[i].empty() && R <= pdf[i].getXmax()) {
 
          JPDF_t::result_type y1 = pdf[i](max(R, pdf[i].getXmin()), theta, phi, t1);
          
          // safety measures
          
          if (y1.f <= 0.0) {
            y1.f  = 0.0;
            y1.fp = 0.0;
          }
          
          if (y1.v <= 0.0) {
            y1.v  = 0.0;
          }
          
          // energy dependence
          
          if        (is_deltarays(pdf_t[i])) {
            y1 *= getDeltaRaysFromMuon(E);
          } else if (is_bremsstrahlung(pdf_t[i])) {
            y1 *= E;
          }
          
          h1 += y1;
        }
      }
 
      return h1;
    }

getH0() [2/2]

JNPE_t::result_type JFIT::JRegressor< JLine3Z, JGandalf >::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 362 of file JLine3ZRegressor.hh.

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

getH1() [2/2]

JNPE_t::result_type JFIT::JRegressor< JLine3Z, JGandalf >::getH1 ( const double  E, const double  R, const double  theta, const double  phi  ) const

inline

Get signal hypothesis value for time integrated PDF.

Parameters

E	muon energy at minimum distance of approach [GeV]
R	minimum distance of approach [m]
theta	PMT zenith angle [rad]
phi	PMT azimuth angle [rad]

Returns

hypothesis value

Definition at line 377 of file JLine3ZRegressor.hh.

    {
      using namespace std;
      using namespace JPP;
 
      JNPE_t::result_type h1 = JMATH::zero;
        
      for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
 
        if (!npe[i].empty() && R <= npe[i].getXmax()) {
 
          try {
 
            JNPE_t::result_type y1 = npe[i](max(R, npe[i].getXmin()), theta, phi);
          
            // safety measures
            
            if (y1.f > 0.0) {
            
              // energy dependence
            
              if        (is_deltarays(pdf_t[i])) {
                y1 *= getDeltaRaysFromMuon(E);
              } else if (is_bremsstrahlung(pdf_t[i])) {
                y1 *= E;
              }
          
              h1 += y1;
            }
          }
          catch(JException& error) {
            ERROR(error << endl);
          }
        }
      }
 
      return h1;
    }

getRmax()

double JFIT::JRegressor< JLine3Z, JGandalf >::getRmax ( ) const

inline

Get maximal road width of PDF.

Returns

road width [m]

Definition at line 425 of file JLine3ZRegressor.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;
    }

operator()() [3/4]

result_type JFIT::JAbstractRegressor< JLine3Z , JGandalf >::operator() ( const JLine3Z &  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 94 of file JRegressor.hh.

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

operator()() [4/4]

template<class JModel_t >

template<class JFunction_t , class T , class ... Args>

result_type JFIT::JGandalf< JModel_t >::operator() ( const JFunction_t &  fit, T  __begin, T  __end, Args ...  args  )

inlineinherited

Multi-dimensional fit of multiple data sets.

The fit function should return the chi2 as well as the partial derivatives for the current value of the model and a given data point.

Parameters

fit	fit function
__begin	begin of data
__end	end of data
args	optional data

Returns

chi2 and gradient

Definition at line 160 of file JGandalf.hh.

    {
      using namespace std;
      using namespace JPP;
 
      // note that all model values should be assigned to the start value of the model before use
      // because the actual list of model parameters can vary from fit to fit
      // (e.g. if model consists of a container).
 
      const size_t N = parameters.size();
 
      V.resize(N);
      h.resize(N);
      x.resize(N);
 
      previous.result.chi2 = numeric_limits<double>::max();
 
      current.result.chi2     = numeric_limits<double>::max();
      current.result.gradient = value;
      current.result.gradient = zero;
 
      error     = value;
      error     = zero;
 
      lambda    = LAMBDA_MIN;
 
      for (numberOfIterations = 0; numberOfIterations != MAXIMUM_ITERATIONS; ++numberOfIterations) {
 
        DEBUG("step:     " << numberOfIterations << endl);
 
        reset();
 
        update(fit, __begin, __end, args...);
 
        DEBUG("lambda:   " << FIXED(12,5) << lambda              << endl);
        DEBUG("chi2:     " << FIXED(12,5) << current.result.chi2 << endl);
 
        if (current.result.chi2 < previous.result.chi2) {
 
          if (numberOfIterations != 0) {
 
            const double tolerance = EPSILON * (EPSILON_ABSOLUTE ? 1.0 : fabs(previous.result.chi2)); 
 
            if (fabs(previous.result.chi2 - current.result.chi2) <= tolerance) {
 
              // normal end
 
              const result_type result = current.result;
 
              reset();
 
              update(fit, __begin, __end, args...);
 
              try {
                V.invert();
              }
              catch (const exception& error) {}
 
              for (size_t i = 0; i != N; ++i) {
                get(error, parameters[i]) = sqrt(V(i,i));
              }
 
              return result;
            }
 
            if (lambda > LAMBDA_MIN) {
              lambda /= LAMBDA_DOWN;
            }
          }
 
          // store current values
 
          previous.value  = value;
          previous.result = current.result;
 
        } else {
 
          value   = previous.value;                                 // restore value
 
          lambda *= LAMBDA_UP;
          
          if (lambda > LAMBDA_MAX) {
            break;
          }
 
          reset();
 
          update(fit, __begin, __end, args...);
        }
 
        DEBUG("Hesse matrix:" << endl << V << endl);
 
        // force definite positiveness
 
        for (size_t i = 0; i != N; ++i) {
 
          if (V(i,i) < PIVOT) {
            V(i,i) = PIVOT;
          }
 
          h[i] = 1.0 / sqrt(V(i,i));
        }
 
        // normalisation
        
        for (size_t row = 0; row != N; ++row) {
          for (size_t col = 0; col != row; ++col) {
            V(row,col) *= h[row] * h[col];
            V(col,row)  = V(row,col);
          }
        }
        
        for (size_t i = 0; i != N; ++i) {
          V(i,i) = 1.0 + lambda;
        }
 
        // solve A x = b
 
        for (size_t col = 0; col != N; ++col) {
          x[col] = h[col] * get(current.result.gradient, parameters[col]);
        }
 
        try {
          V.solve(x);
        }
        catch (const exception& error) {
 
          ERROR("JGandalf: " << error.what() << endl << V << endl);
 
          break;
        }
 
        // update value
 
        for (size_t row = 0; row != N; ++row) {
 
          DEBUG("u[" << noshowpos << setw(3) << row << "] = " << showpos << FIXED(15,5) << get(value, parameters[row]));
 
          get(value, parameters[row]) -= h[row] * x[row];
 
          DEBUG(" -> " << FIXED(15,5) << get(value, parameters[row]) << noshowpos << endl);
        }
 
        model(value);
      }
 
      // abnormal end
 
      const result_type result = previous.result;
 
      value   = previous.value;                                     // restore value
 
      reset();
 
      update(fit, __begin, __end, args...);
 
      try {
        V.invert();
      }
      catch (const exception& error) {}
 
      for (size_t i = 0; i != N; ++i) {
        get(error, parameters[i]) = sqrt(V(i,i));
      }
 
      return result;
    }

reset()

template<class JModel_t >

void JFIT::JGandalf< JModel_t >::reset ( )

inlineprivateinherited

Reset current parameters.

Definition at line 349 of file JGandalf.hh.

    {
      using namespace JPP;
 
      current.result.chi2     = 0.0;
      current.result.gradient = zero;
 
      V.reset();          
    }

update() [1/2]

template<class JModel_t >

template<class JFunction_t , class T , class ... Args>

void JFIT::JGandalf< JModel_t >::update ( const JFunction_t &  fit, T  __begin, T  __end, Args ...  args  )

inlineprivateinherited

Recursive method to update current parameters.

Parameters

fit	fit function
__begin	begin of data
__end	end of data
args	optional data

Definition at line 369 of file JGandalf.hh.

    {
      for (T i = __begin; i != __end; ++i) {
 
        const result_type& result = fit(value, *i);
 
        current.result.chi2     += result.chi2;
        current.result.gradient += result.gradient;
 
        for (size_t row = 0; row != parameters.size(); ++row) {
          for (size_t col = row; col != parameters.size(); ++col) {
            V(row,col) += get(result.gradient, parameters[row]) * get(result.gradient, parameters[col]);
          }
        }
      }
 
      update(fit, args...);
    }

update() [2/2]

template<class JModel_t >

template<class JFunction_t >

void JFIT::JGandalf< JModel_t >::update ( const JFunction_t &  fit )

inlineprivateinherited

Termination method to update current parameters.

Parameters

fit	fit function

Definition at line 395 of file JGandalf.hh.

    {
      for (size_t row = 0; row != parameters.size(); ++row) {
        for (size_t col = 0; col != row; ++col) {
          V(row,col) = V(col,row);
        }
      }
    }

get() [1/6]

template<class JModel_t >

static double JFIT::JGandalf< JModel_t >::get ( const JModel_t &  model, double JModel_t::*  parameter  )

inlinestaticprivateinherited

Read/write access to parameter value by data member.

Parameters

model	model
parameter	parameter

Returns

value

Definition at line 412 of file JGandalf.hh.

    {
      return model.*parameter;
    }

get() [2/6]

template<class JModel_t >

static double& JFIT::JGandalf< JModel_t >::get ( JModel_t &  model, double JModel_t::*  parameter  )

inlinestaticprivateinherited

Read/write access to parameter value by data member.

Parameters

model	model
parameter	parameter

Returns

value

Definition at line 425 of file JGandalf.hh.

    {
      return model.*parameter;
    }

get() [3/6]

template<class JModel_t >

static double JFIT::JGandalf< JModel_t >::get ( const JModel_t &  model, const size_t  index  )

inlinestaticprivateinherited

Read/write access to parameter value by index.

Parameters

model	model
index	index

Returns

value

Definition at line 438 of file JGandalf.hh.

    {
      return model[index];
    }

get() [4/6]

template<class JModel_t >

static double& JFIT::JGandalf< JModel_t >::get ( JModel_t &  model, const size_t  index  )

inlinestaticprivateinherited

Read/write access to parameter value by index.

Parameters

model	model
index	index

Returns

value

Definition at line 451 of file JGandalf.hh.

    {
      return model[index];
    }

get() [5/6]

template<class JModel_t >

static double JFIT::JGandalf< JModel_t >::get ( const JModel_t &  model, const int  index  )

inlinestaticprivateinherited

Read/write access to parameter value by index.

Parameters

model	model
index	index

Returns

value

Definition at line 464 of file JGandalf.hh.

    {
      return model[index];
    }

get() [6/6]

template<class JModel_t >

static double& JFIT::JGandalf< JModel_t >::get ( JModel_t &  model, const int  index  )

inlinestaticprivateinherited

Read/write access to parameter value by index.

Parameters

model	model
index	index

Returns

value

Definition at line 477 of file JGandalf.hh.

    {
      return model[index];
    }

getPDF()

const JPDFs_t& JFIT::JRegressorStorage< JLine3Z, JGandalf >::getPDF ( ) const

inlineinherited

Get PDFs.

Returns

PDFs

Definition at line 172 of file JRegressorHelper.hh.

    {
      return _pdf;
    }

getNPE()

const JNPEs_t& JFIT::JRegressorStorage< JLine3Z, JGandalf >::getNPE ( ) const

inlineinherited

Get NPEs.

Returns

NPEs

Definition at line 183 of file JRegressorHelper.hh.

    {
      return _npe;
    }

transform()

void JFIT::JRegressorStorage< JLine3Z, JGandalf >::transform ( const transformer_type &  transformer )

inlineinherited

Transform PDFs and NPEs.

Parameters

transformer

transformer

Definition at line 194 of file JRegressorHelper.hh.

    {
      for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
        _pdf[i].transform(transformer);
        _npe[i].transform(transformer);
      }
    }

setRmax()

void JFIT::JRegressorStorage< JLine3Z, JGandalf >::setRmax ( const double  Rmax )

inlineinherited

Set maximal road width of PDF.

Parameters

Rmax	road width [m]

Definition at line 208 of file JRegressorHelper.hh.

    {
      const JTOOLS::JRange<typename JFunction1D_t::abscissa_type> range(0.0, Rmax);
      
      for (int i = 0; i != NUMBER_OF_PDFS; ++i) {
        if (!_pdf[i].empty()) {
          _pdf[i].compress(range);
        }
      }
    }

Member Data Documentation

T_ns

JTimeRange JFIT::JRegressor< JLine3Z, JGandalf >::T_ns

static

Time window with respect to Cherenkov hypothesis [ns].

Default values.

Definition at line 439 of file JLine3ZRegressor.hh.

Vmax_npe

double JFIT::JRegressor< JLine3Z, JGandalf >::Vmax_npe = std::numeric_limits<double>::max()

static

Maximal integral of PDF [npe].

Definition at line 440 of file JLine3ZRegressor.hh.

Rmin_m

double JFIT::JRegressor< JLine3Z, JGandalf >::Rmin_m = 0.1

static

Minimal distance of [m].

Definition at line 441 of file JLine3ZRegressor.hh.

pdf

const JPDFs_t& JFIT::JRegressor< JLine3Z, JGandalf >::pdf

PDF.

Definition at line 443 of file JLine3ZRegressor.hh.

npe

const JNPEs_t& JFIT::JRegressor< JLine3Z, JGandalf >::npe

PDF.

Definition at line 444 of file JLine3ZRegressor.hh.

E_GeV

double JFIT::JRegressor< JLine3Z, JGandalf >::E_GeV = 0.0

Energy of muon at vertex [GeV].

Definition at line 446 of file JLine3ZRegressor.hh.

estimator

JLANG::JSharedPointer<JMEstimator> JFIT::JRegressor< JLine3Z, JGandalf >::estimator = new JMEstimatorNormal()

M-Estimator function.

Definition at line 448 of file JLine3ZRegressor.hh.

MAXIMUM_ITERATIONS

template<class JModel_t >

int JFIT::JGandalf< JModel_t >::MAXIMUM_ITERATIONS = 1000

staticinherited

maximal number of iterations

maximal number of iterations.

Definition at line 329 of file JGandalf.hh.

EPSILON

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::EPSILON = 1.0e-3

staticinherited

maximal distance to minimum

maximal distance to minimum.

Definition at line 330 of file JGandalf.hh.

EPSILON_ABSOLUTE

template<class JModel_t >

bool JFIT::JGandalf< JModel_t >::EPSILON_ABSOLUTE = false

staticinherited

set epsilon to absolute difference instead of relative

set epsilon to absolute difference instead of relative.

Definition at line 331 of file JGandalf.hh.

LAMBDA_MIN

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::LAMBDA_MIN = 0.01

staticinherited

minimal value control parameter

Definition at line 332 of file JGandalf.hh.

LAMBDA_MAX

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::LAMBDA_MAX = 100.0

staticinherited

maximal value control parameter

Definition at line 333 of file JGandalf.hh.

LAMBDA_UP

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::LAMBDA_UP = 10.0

staticinherited

multiplication factor control parameter

Definition at line 334 of file JGandalf.hh.

LAMBDA_DOWN

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::LAMBDA_DOWN = 10.0

staticinherited

multiplication factor control parameter

Definition at line 335 of file JGandalf.hh.

PIVOT

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::PIVOT = std::numeric_limits<double>::epsilon()

staticinherited

minimal value diagonal element of Hesse matrix

minimal value diagonal element of matrix

Definition at line 336 of file JGandalf.hh.

parameters

template<class JModel_t >

std::vector<parameter_type> JFIT::JGandalf< JModel_t >::parameters

inherited

fit parameters

Definition at line 338 of file JGandalf.hh.

numberOfIterations

template<class JModel_t >

int JFIT::JGandalf< JModel_t >::numberOfIterations

inherited

number of iterations

Definition at line 339 of file JGandalf.hh.

lambda

template<class JModel_t >

double JFIT::JGandalf< JModel_t >::lambda

inherited

control parameter

Definition at line 340 of file JGandalf.hh.

value

template<class JModel_t >

JModel_t JFIT::JGandalf< JModel_t >::value

inherited

value

Definition at line 341 of file JGandalf.hh.

error

template<class JModel_t >

JModel_t JFIT::JGandalf< JModel_t >::error

inherited

error

Definition at line 342 of file JGandalf.hh.

V

template<class JModel_t >

JMATH::JMatrixNS JFIT::JGandalf< JModel_t >::V

inherited

Hesse matrix.

Definition at line 343 of file JGandalf.hh.

h

template<class JModel_t >

std::vector<double> JFIT::JGandalf< JModel_t >::h

privateinherited

Definition at line 482 of file JGandalf.hh.

x

template<class JModel_t >

JMATH::JVectorND JFIT::JGandalf< JModel_t >::x

privateinherited

Definition at line 483 of file JGandalf.hh.

result

template<class JModel_t >

result_type JFIT::JGandalf< JModel_t >::result

inherited

Definition at line 486 of file JGandalf.hh.

struct { ... } JFIT::JGandalf< JModel_t >::current

struct { ... } JFIT::JGandalf< JModel_t >::previous

debug

template<class T >

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

staticinherited

debug level (default is off).

Definition at line 45 of file JMessage.hh.

_pdf

JPDFs_t JFIT::JRegressorStorage< JLine3Z, JGandalf >::_pdf

privateinherited

PDFs.

Definition at line 221 of file JRegressorHelper.hh.

_npe

JNPEs_t JFIT::JRegressorStorage< JLine3Z, JGandalf >::_npe

privateinherited

NPEs.

Definition at line 222 of file JRegressorHelper.hh.

NUMBER_OF_PDFS

const int JFIT::JRegressorHelper< JLine3Z, JGandalf >::NUMBER_OF_PDFS = 6

staticinherited

Number of PDFs.

Definition at line 70 of file JRegressorHelper.hh.

pdf_t

const JPDFType_t JFIT::JRegressorHelper< JLine3Z, JGandalf >::pdf_t

staticinherited

Initial value:

= { DIRECT_LIGHT_FROM_MUON,
                                                                    SCATTERED_LIGHT_FROM_MUON,
                                                                    DIRECT_LIGHT_FROM_DELTARAYS,
                                                                    SCATTERED_LIGHT_FROM_DELTARAYS,
                                                                    DIRECT_LIGHT_FROM_EMSHOWERS,
                                                                    SCATTERED_LIGHT_FROM_EMSHOWERS }

PDF types.

Definition at line 79 of file JRegressorHelper.hh.

---

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

• JLine3ZRegressor.hh