RecoLocalFastTime/FTLClusterizer/interface/MTDThresholdClusterizer.h - master - githubmirror/cmssw

RecoLocalFastTime/FTLClusterizer/interface/MTDThresholdClusterizer.h
91 строка3 KB
Fabio Cossutti
replace fillDescriptions with fillPSetDescription
11 май 2021, 10:45
11 май 2021, 10:4576ce1c8
#ifndef RecoLocalTracker_FTLClusterizer_MTDThresholdClusterizer_H
#define RecoLocalTracker_FTLClusterizer_MTDThresholdClusterizer_H

//-----------------------------------------------------------------------
//! \class MTDThresholdClusterizer
//! \brief An explicit threshold-based clustering algorithm.
//!
//! A threshold-based clustering algorithm which clusters FTLRecHits
//! into FTLClusters for each DetUnit.  The algorithm is straightforward
//! and purely topological: the clustering process starts with seed hits
//! and continues by adding adjacent hits above the hit threshold.
//! Once the cluster is made, it has to be above the cluster threshold as
//! well.
//!
//! The clusterization is performed on a matrix with size
//! equal to the size of the MTD detector, each cell containing
//! the cahrge and time of the corresponding hit
//! The matrix is reset after each clusterization.
//!
//! The search starts from seed hits, i.e. hits with sufficiently
//! large amplitudes
//!
//! FTLCluster contains a barycenter, but it should be noted that that
//! information is largely useless.  One must use a PositionEstimator
//! class to compute the RecHit position and its error for every given
//! cluster.
//!
//! Sets the MTDArrayBuffer dimensions and pixel thresholds.
//! Makes clusters and stores them in theCache if the option
//! useCache has been set.
//-----------------------------------------------------------------------

// Base class, defines FTLRecHit and FLTCluster.  The latter includes
// FTLHit, FTLHitPos and Shift as inner classes.
//
#include "RecoLocalFastTime/FTLClusterizer/interface/MTDClusterizerBase.h"

// The private pixel buffer
#include "MTDArrayBuffer.h"

// Parameter Set:
#include "FWCore/ParameterSet/interface/ParameterSet.h"

#include "FWCore/ParameterSet/interface/ConfigurationDescriptions.h"
#include "FWCore/ParameterSet/interface/ParameterSetDescription.h"

#include <vector>

#include "Geometry/MTDGeometryBuilder/interface/MTDGeometry.h"

class MTDThresholdClusterizer : public MTDClusterizerBase {
public:
  MTDThresholdClusterizer(edm::ParameterSet const& conf);
  ~MTDThresholdClusterizer() override;

  // Full I/O in DetSet
  void clusterize(const FTLRecHitCollection& input,
                  const MTDGeometry* geom,
                  const MTDTopology* topo,
                  FTLClusterCollection& output) override;

  static void fillPSetDescription(edm::ParameterSetDescription& desc);

private:
  std::vector<FTLCluster::FTLHitPos> theSeeds;  // cached seed pixels
  std::vector<FTLCluster> theClusters;          // resulting clusters

  //! Clustering-related quantities:
  const float theHitThreshold;       // Hit threshold
  const float theSeedThreshold;      // MTD cluster seed
  const float theClusterThreshold;   // Cluster threshold
  const float theTimeThreshold;      // Time compatibility between new hit and seed
  const float thePositionThreshold;  // Position threshold between new hit and seed

  //! Geometry-related information
  int theNumOfRows;
  int theNumOfCols;

  DetId theCurrentId;

  //! Data storage
  MTDArrayBuffer theBuffer;  // internal nrow * ncol matrix
  bool bufferAlreadySet;     // status of the buffer array

  bool setup(const MTDGeometry* geometry, const MTDTopology* topo, const DetId& id);
  void copy_to_buffer(RecHitIterator itr, const MTDGeometry* geom, const MTDTopology* topo);
  void clear_buffer(RecHitIterator itr);
  FTLCluster make_cluster(const FTLCluster::FTLHitPos& hit);
};

#endif