AbsHFPhase1Algo.h

Go to the documentation of this file.

#ifndef RecoLocalCalo_HcalRecAlgos_AbsHFPhase1Algo_h_
#define RecoLocalCalo_HcalRecAlgos_AbsHFPhase1Algo_h_

#include "DataFormats/HcalRecHit/interface/HFRecHit.h"
#include "DataFormats/HcalRecHit/interface/HFPreRecHit.h"
#include "CalibFormats/HcalObjects/interface/HcalCalibrations.h"

class AbsHcalAlgoData;

//
// It is assumed that the HF Phase 1 algorithms will be developed
// utilizing pairs of classes: a DB class with relevant calibration
// constants and configuration parameters, derived from AbsHcalAlgoData,
// and the algo class, derived from AbsHFPhase1Algo, utilizing that DB class.
//
// We can expect that the same calibration constants might be utilized
// by different reco algorithms.
//
// In principle, of course, the configuration objects do not have to be
// actually stored in the database. It is expected that, at the early
// stages of our understanding of energy reconstruction with dual-anode
// PMTs, these objects will be created from the module configuration
// parameters.
//
class AbsHFPhase1Algo
{
public:
    inline virtual ~AbsHFPhase1Algo() {}

    // Does this class expect to receive its configuration from the database?
    virtual bool isConfigurable() const = 0;

    // If using DB, expect that the configuration will be updated
    // once per run. We will not manage the pointer here. "true"
    // should be returned on success (typically, automatic cast
    // from the pointer checked by the appropriate dynamic cast).
    inline virtual bool configure(const AbsHcalAlgoData*) {return false;}

    // Convention: if we do not want to use the given HFPreRecHit
    // at all (i.e., it is to be discarded), the returned HFRecHit
    // should have its id (of type HcalDetId) set to 0.
    virtual HFRecHit reconstruct(const HFPreRecHit& prehit,
                                 const HcalCalibrations& calibs,
                                 const bool flaggedBadInDB[2],
                                 bool expectSingleAnodePMT) = 0;
};

#endif // RecoLocalCalo_HcalRecAlgos_AbsHFPhase1Algo_h_