Detector smearing & efficiency functions

Topics
	Experiment-specific electron efficiency and smearing functions
	Experiment-specific photon efficiency and smearing functions
	Experiment-specific muon efficiency and smearing functions
	Experiment-specific tau efficiency and smearing functions
	Experiment-specific jet efficiency and smearing functions
	Experiment-specific missing-ET smearing functions
	Experiment-specific tracking efficiency and smearing functions
	Generic jet filtering, efficiency and smearing utils
	Generic 4-momentum filtering, efficiency and smearing utils

A full family of identity smearing functions
double	Rivet::ELECTRON_EFF_IDENTITY_LOOSE (const Particle &e)
double	Rivet::ELECTRON_EFF_IDENTITY_MEDIUM (const Particle &e)
double	Rivet::ELECTRON_EFF_IDENTITY_TIGHT (const Particle &e)
double	Rivet::MUON_EFF_IDENTITY_LOOSE (const Particle &m)
double	Rivet::MUON_EFF_IDENTITY_MEDIUM (const Particle &m)
double	Rivet::MUON_EFF_IDENTITY_TIGHT (const Particle &m)
double	Rivet::PHOTON_EFF_IDENTITY_LOOSE (const Particle &y)
double	Rivet::PHOTON_EFF_IDENTITY_MEDIUM (const Particle &y)
double	Rivet::PHOTON_EFF_IDENTITY_TIGHT (const Particle &y)
double	Rivet::TAU_EFF_IDENTITY_LOOSE (const Particle &t)
double	Rivet::TAU_EFF_IDENTITY_MEDIUM (const Particle &t)
double	Rivet::TAU_EFF_IDENTITY_TIGHT (const Particle &t)
Particle	Rivet::ELECTRON_SMEAR_IDENTITY (const Particle &e)
Particle	Rivet::MUON_SMEAR_IDENTITY (const Particle &m)
Particle	Rivet::PHOTON_SMEAR_IDENTITY (const Particle &y)
Particle	Rivet::TAU_SMEAR_IDENTITY (const Particle &t)
double	Rivet::TRK_EFF_IDENTITY_TIGHT (const Particle &trk)
Particle	Rivet::TRK_SMEAR_IDENTITY (const Particle &trk)
double	Rivet::JET_BTAG_IDENTITY_IDENTITY (const Jet &j)

Detailed Description

A family of smearing functions must include the following names and return types:

ParticleEffFn <PARTICLE>EFF<FAMILY>_<IDCLASS> ParticleSmearFn <PARTICLE>SMEAR<FAMILY> ParticleEffFn TRK_EFF_<FAMILY> ParticleSmearFn TRK_SMEAR_<FAMILY> JetEffFn JET_BTAG_<FAMILY>_<TAGGER> JetSmearFn JET_SMEAR_<FAMILY> METSmearParamsFn MET_SMEARPARAMS_<FAMILY> METSmearFn MET_SMEAR_<FAMILY>

where <PARTICLE> is all of ELECTRON, MUON, PHOTON, and TAU, <IDCLASS> is all of LOOSE, MEDIUM, and TIGHT. The family name and tagger name are free (within the constraints of function naming. Providing a full set may require use of alias/wrapper functions and/or the predefined eff/smearing IDENTITY functions.