Kinematic-fitting convenience functions
7.5.4. Kinematic-fitting convenience functions#
The Orca kinematic fitter is a global fitting tool.
A typical use-case would be to constrain the 4-momentum of all particles provided to the 4-momentum of the beam. This is a “4C” fit (four constraints).
Note
By default, the 4-momentum of the beam is taken without uncertainties.
Running this fit updates the chiProb
of the mother particle.
Important
Please also see the list of special Orca Kinematic Fitter variables.
- kinfit.MassfitKinematic1C(list_name, invMass, fitterEngine='NewFitterGSL', constraint='Mass', daughtersUpdate=True, path=None)[source]#
Perform recoil mass kinematic fit for particles in the given ParticleList.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass or Mass
invMass – Invariant Mass (GeV)
daughtersUpdate – make copy of the daughters and update them after the vertex fit
path – modules are added to this path
- kinfit.MassfitKinematic1CRecoil(list_name, recoilMass, fitterEngine='NewFitterGSL', constraint='RecoilMass', daughtersUpdate=True, path=None)[source]#
Perform recoil mass kinematic fit for particles in the given ParticleList.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass
recoilMass – RecoilMass (GeV)
daughtersUpdate – make copy of the daughters and update them after the vertex fit
path – modules are added to this path
- kinfit.UnmeasuredfitKinematic1C(list_name, fitterEngine='NewFitterGSL', constraint='HardBeam', daughtersUpdate=True, path=None)[source]#
Perform 1C momentum constraint kinematic fit with one unmeasured photon for particles in the given ParticleList.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass
daughtersUpdate – make copy of the daughters and update them after the vertex fit
path – modules are added to this path
- kinfit.fitKinematic2C(list_name, fitterEngine='NewFitterGSL', constraint='HardBeam', daughtersUpdate=True, addUnmeasuredPhotonAlongBeam='', path=None)[source]#
Perform 2C momentum constraint kinematic fit. The photon with unmeasured energy and theta has to be the first particle in the decay string. If ‘addUnmeasuredPhotonAlongBeam’ is set to ‘HER’ or ‘LER’, both phi and theta (treated as measured) of this photon are then used. Concurrently, an additional unmeasured photon along HER/LER will be taken into account in the fit, which means the momentum is only constrained in the plane perpendicular to one of the beams.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass
daughtersUpdate – make copy of the daughters and update them after the vertex fit
addUnmeasuredPhotonAlongBeam – add an unmeasured photon along beam if ‘HER’ or ‘LER’ is set
path – modules are added to this path
- kinfit.fitKinematic3C(list_name, fitterEngine='NewFitterGSL', constraint='HardBeam', daughtersUpdate=True, addUnmeasuredPhoton=False, add3CPhoton=True, path=None)[source]#
Perform 3C momentum constraint kinematic fit with one photon with unmeasured energy for particles in the given ParticleList, the first daughter should be the energy unmeasured Photon.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass
daughtersUpdate – make copy of the daughters and update them after the vertex fit
addUnmeasuredPhoton – add one unmeasured photon (uses up three constraints)
add3CPhoton – add one photon with unmeasured energy (uses up a constraint)
path – modules are added to this path
- kinfit.fitKinematic4C(list_name, fitterEngine='NewFitterGSL', constraint='HardBeam', daughtersUpdate=True, addUnmeasuredPhoton=False, path=None)[source]#
Perform a 4C momentum constraint kinematic fit for particles in the given ParticleList.
- Parameters
list_name – name of the input ParticleList
fitterEngine – which fitter engine to use? ‘NewFitterGSL’ or ‘OPALFitterGSL’
constraint – HardBeam or RecoilMass
daughtersUpdate – make copy of the daughters and update them after the vertex fit
addUnmeasuredPhoton – add one unmeasured photon (uses up three constraints)
path – modules are added to this path
See also
The ParticleKinematicFitter
documentation if you prefer to
directly configure the module yourself.