JNPE.hh

Go to the documentation of this file.

#ifndef __JFIT__JNPE__
#define __JFIT__JNPE__

#include <cmath>

#include "JTools/JConstants.hh"
#include "JPhysics/JPDFToolkit.hh"
#include "JFit/JK40.hh"
#include "JFit/JFitToolkit.hh"


/**
 * \author mdejong
 */

namespace JFIT {}
namespace JPP { using namespace JFIT; }

namespace JFIT {
  
  /**
   * Auxiliary class for handling various light yields.
   * Note that the effective light yield due to bremsstrahlung is proportional to the muon energy.
   * The position along the muon path is used to correct for the energy loss of the muon 
   * between the reference position (z = 0) and the point of emission of the light. 
   */
  struct JNPE :
    public JK40
  {
    
    using JK40::getP;

    
    /**
     * Default constructor.
     */
    JNPE() :
      JK40(),
      __yA(0.0),
      __yB(0.0),
      __z (0.0)
    {}


    /**
     * Constructor.
     *
     * \param  k40                K40 light yields [npe]
     * \param  yA                 light yield due to minimum ionizing particle [npe]
     * \param  yB                 light yield due to bremsstrahlung            [npe/GeV]
     * \param  z                  position along muon path [m]
     */
    JNPE(const JK40&  k40,
         const double yA,
         const double yB,
         const double z) :
      JK40(k40),
      __yA(yA),
      __yB(yB),
      __z (z)
    {}


    /**
     * Get light yield due to muon itself.
     *
     * \return                    light yield [npe]
     */
    double getYA() const
    {
      return __yA;
    }


    /**
     * Get light yield due to bremsstrahlung.
     *
     * \return                    light yield [npe/GeV]
     */
    double getYB() const
    {
      return __yB;
    }


    /**
     * Get position along muon path.
     *
     * \return                    position along muon path [m]
     */
    double getZ() const
    {
      return __z;
    }


    /**
     * Expected number of photo-electrons for random background hypothesis.
     *
     * \return                    light yield [npe]
     */
    inline double getH0() const
    {
      return this->getY0();
    }


    /**
     * Expected number of photo-electrons for random background hypothesis.
     *
     * \param  M                  multiplicity
     * \return                    light yield [npe]
     */
    inline double getH0(const size_t M) const
    {
      return this->getY1(M);
    }

    
    /**
     * Expected number of photo-electrons for muon hypothesis as a function of muon energy.
     *
     * \param  E_GeV              energy [GeV]
     * \return                    light yield [npe]
     */
    inline double getH1(const double E_GeV) const
    {
      using namespace JTOOLS;
      using namespace JPHYSICS;

      const double E = gWater.getE(E_GeV, this->getZ());

      if (E >= MASS_MUON * INDEX_OF_REFRACTION_WATER)
        return this->getYA() + E * this->getYB();
      else
        return 0.0;
    }


    /**
     * Get probability for observing a hit or not as a function of muon energy.
     *
     * \param  E_GeV              energy [GeV]
     * \param  hit                hit
     * \return                    probability
     */
    double getP(const double E_GeV, const bool hit) const
    {
      return JFIT::getP(this->getH1(E_GeV) + this->getH0(), hit);
    }


    /**
     * Get chi2 for observing a hit or not as a function of muon energy.
     *
     * \param  E_GeV              energy [GeV]
     * \param  hit                hit
     * \return                    probability
     */
    double getChi2(const double E_GeV, const bool hit) const
    {
      return JFIT::getChi2(this->getH1(E_GeV) + this->getH0(), hit);
    }

  protected:
    double __yA;      //!< light yield due to minimum ionizing particle [npe]
    double __yB;      //!< light yield due to bremsstrahlung            [npe/GeV]
    double __z;       //!< position along muon path [m]
  };
}

#endif