cluster::ClusterCrawler Class Reference

Inheritance diagram for cluster::ClusterCrawler:

Public Member Functions
	ClusterCrawler (fhicl::ParameterSet const &pset)
Public Member Functions inherited from art::EDProducer
	EDProducer (fhicl::ParameterSet const &pset)
template<typename Config >
	EDProducer (Table< Config > const &config)
std::string	workerType () const
Public Member Functions inherited from art::detail::Producer
virtual	~Producer () noexcept
	Producer (fhicl::ParameterSet const &)
	Producer (Producer const &)=delete
	Producer (Producer &&)=delete
Producer &	operator= (Producer const &)=delete
Producer &	operator= (Producer &&)=delete
void	doBeginJob (SharedResources const &resources)
void	doEndJob ()
void	doRespondToOpenInputFile (FileBlock const &fb)
void	doRespondToCloseInputFile (FileBlock const &fb)
void	doRespondToOpenOutputFiles (FileBlock const &fb)
void	doRespondToCloseOutputFiles (FileBlock const &fb)
bool	doBeginRun (RunPrincipal &rp, ModuleContext const &mc)
bool	doEndRun (RunPrincipal &rp, ModuleContext const &mc)
bool	doBeginSubRun (SubRunPrincipal &srp, ModuleContext const &mc)
bool	doEndSubRun (SubRunPrincipal &srp, ModuleContext const &mc)
bool	doEvent (EventPrincipal &ep, ModuleContext const &mc, std::atomic< std::size_t > &counts_run, std::atomic< std::size_t > &counts_passed, std::atomic< std::size_t > &counts_failed)
Public Member Functions inherited from art::Modifier
	~Modifier () noexcept
	Modifier ()
	Modifier (Modifier const &)=delete
	Modifier (Modifier &&)=delete
Modifier &	operator= (Modifier const &)=delete
Modifier &	operator= (Modifier &&)=delete
Public Member Functions inherited from art::ModuleBase
virtual	~ModuleBase () noexcept
	ModuleBase ()
ModuleDescription const &	moduleDescription () const
void	setModuleDescription (ModuleDescription const &)
std::array< std::vector< ProductInfo >, NumBranchTypes > const &	getConsumables () const
void	sortConsumables (std::string const &current_process_name)
template<typename T , BranchType BT>
ViewToken< T >	consumesView (InputTag const &tag)
template<typename T , BranchType BT>
ViewToken< T >	mayConsumeView (InputTag const &tag)

Private Member Functions
void	produce (art::Event &evt) override

Private Attributes
hit::CCHitFinderAlg	fCCHFAlg
ClusterCrawlerAlg	fCCAlg
std::string	fCalDataModuleLabel
	label of module producing input wires More...

Additional Inherited Members
Public Types inherited from art::EDProducer
using	ModuleType = EDProducer
using	WorkerType = WorkerT< EDProducer >
Public Types inherited from art::detail::Producer
template<typename UserConfig , typename KeysToIgnore = void>
using	Table = Modifier::Table< UserConfig, KeysToIgnore >
Public Types inherited from art::Modifier
template<typename UserConfig , typename UserKeysToIgnore = void>
using	Table = ProducerTable< UserConfig, detail::ModuleConfig, UserKeysToIgnore >
Static Public Member Functions inherited from art::EDProducer
static void	commitEvent (EventPrincipal &ep, Event &e)
Protected Member Functions inherited from art::ModuleBase
ConsumesCollector &	consumesCollector ()
template<typename T , BranchType = InEvent>
ProductToken< T >	consumes (InputTag const &)
template<typename Element , BranchType = InEvent>
ViewToken< Element >	consumesView (InputTag const &)
template<typename T , BranchType = InEvent>
void	consumesMany ()
template<typename T , BranchType = InEvent>
ProductToken< T >	mayConsume (InputTag const &)
template<typename Element , BranchType = InEvent>
ViewToken< Element >	mayConsumeView (InputTag const &)
template<typename T , BranchType = InEvent>
void	mayConsumeMany ()

Detailed Description

Definition at line 38 of file ClusterCrawler_module.cc.

Constructor & Destructor Documentation

cluster::ClusterCrawler::ClusterCrawler ( fhicl::ParameterSet const &  pset )

explicit

Definition at line 53 of file ClusterCrawler_module.cc.

    : EDProducer{pset}
    , fCCHFAlg(pset.get<fhicl::ParameterSet>("CCHitFinderAlg"))
    , fCCAlg(pset.get<fhicl::ParameterSet>("ClusterCrawlerAlg"))
    , fCalDataModuleLabel(pset.get<std::string>("CalDataModuleLabel"))
  {
    mf::LogWarning("ClusterCrawler")
      << "\nClusterCrawler module has been deprecated and will be removed."
         "\nIt is now replaced by HitFinder and LineCluster modules.";

    // let HitCollectionAssociator declare that we are going to produce
    // hits and associations with wires and raw digits
    // (with no particular product label)
    recob::HitCollectionAssociator::declare_products(producesCollector());

    produces<std::vector<recob::Cluster>>();
    produces<std::vector<recob::Vertex>>();
    produces<art::Assns<recob::Cluster, recob::Hit>>();
    produces<art::Assns<recob::Cluster, recob::Vertex, unsigned short>>();
  }

Member Function Documentation

void cluster::ClusterCrawler::produce ( art::Event &  evt )

overrideprivatevirtual

Implements art::EDProducer.

Definition at line 75 of file ClusterCrawler_module.cc.

  {
    // fetch the wires needed by CCHitFinder

    // make this accessible to ClusterCrawler_module
    art::ValidHandle<std::vector<recob::Wire>> wireVecHandle =
      evt.getValidHandle<std::vector<recob::Wire>>(fCalDataModuleLabel);

    // find hits in all planes
    fCCHFAlg.RunCCHitFinder(*wireVecHandle);

    // extract the result of the algorithm (it's moved)
    std::vector<recob::Hit> FirstHits = fCCHFAlg.YieldHits();

    auto const clock_data =
      art::ServiceHandle<detinfo::DetectorClocksService const>()->DataFor(evt);
    auto const det_prop =
      art::ServiceHandle<detinfo::DetectorPropertiesService const>()->DataFor(evt, clock_data);

    // look for clusters in all planes
    fCCAlg.RunCrawler(clock_data, det_prop, FirstHits);

    auto FinalHits = std::make_unique<std::vector<recob::Hit>>(fCCAlg.YieldHits());

    art::ServiceHandle<geo::Geometry const> geo;

    // shcol contains the hit collection
    // and its associations to wires and raw digits;
    // we get the association to raw digits through wire associations
    recob::HitCollectionAssociator shcol(evt, fCalDataModuleLabel, true);
    std::vector<recob::Cluster> sccol;
    std::vector<recob::Vertex> sv3col;

    auto hc_assn = std::make_unique<art::Assns<recob::Cluster, recob::Hit>>();
    auto cv_assn = std::make_unique<art::Assns<recob::Cluster, recob::Vertex, unsigned short>>();

    std::vector<ClusterCrawlerAlg::ClusterStore> const& tcl = fCCAlg.GetClusters();

    std::vector<short> const& inClus = fCCAlg.GetinClus();

    // Consistency check
    for (unsigned int icl = 0; icl < tcl.size(); ++icl) {
      ClusterCrawlerAlg::ClusterStore const& clstr = tcl[icl];
      if (clstr.ID < 0) continue;
      geo::PlaneID planeID = ClusterCrawlerAlg::DecodeCTP(clstr.CTP);
      unsigned short plane = planeID.Plane;
      for (unsigned short ii = 0; ii < clstr.tclhits.size(); ++ii) {
        unsigned int iht = clstr.tclhits[ii];
        recob::Hit const& theHit = FinalHits->at(iht);
        if (theHit.WireID().Plane != plane) {
          std::cout << "CC: cluster-hit plane mis-match " << theHit.WireID().Plane << " " << plane
                    << " in cluster " << clstr.ID << " WT " << clstr.BeginWir << ":"
                    << (int)clstr.BeginTim << "\n";
          return;
        }
        if (inClus[iht] != clstr.ID) {
          std::cout << "CC: InClus mis-match " << inClus[iht] << " ID " << clstr.ID
                    << " in cluster " << icl << "\n";
          return;
        }
      } // ii
    }   // icl

    // make 3D vertices
    std::vector<ClusterCrawlerAlg::Vtx3Store> const& Vertices = fCCAlg.GetVertices();

    double xyz[3] = {0, 0, 0};
    unsigned int vtxID = 0, end;
    for (ClusterCrawlerAlg::Vtx3Store const& vtx3 : Vertices) {
      // ignore incomplete vertices
      if (vtx3.Ptr2D[0] < 0) continue;
      if (vtx3.Ptr2D[1] < 0) continue;
      if (vtx3.Ptr2D[2] < 0) continue;
      ++vtxID;
      xyz[0] = vtx3.X;
      xyz[1] = vtx3.Y;
      xyz[2] = vtx3.Z;
      sv3col.emplace_back(xyz, vtxID);
    } // 3D vertices
    // convert Vertex vector to unique_ptrs
    std::unique_ptr<std::vector<recob::Vertex>> v3col(
      new std::vector<recob::Vertex>(std::move(sv3col)));

    // make the clusters and associations
    float sumChg, sumADC;
    unsigned int clsID = 0, nclhits;
    for (unsigned int icl = 0; icl < tcl.size(); ++icl) {
      ClusterCrawlerAlg::ClusterStore const& clstr = tcl[icl];
      if (clstr.ID < 0) continue;
      ++clsID;
      sumChg = 0;
      sumADC = 0;
      geo::PlaneID planeID = ClusterCrawlerAlg::DecodeCTP(clstr.CTP);
      unsigned short plane = planeID.Plane;
      nclhits = clstr.tclhits.size();
      std::vector<unsigned int> clsHitIndices;
      // correct the hit indices to refer to the valid hits that were just added
      for (unsigned int itt = 0; itt < nclhits; ++itt) {
        unsigned int iht = clstr.tclhits[itt];
        recob::Hit const& hit = FinalHits->at(iht);
        sumChg += hit.Integral();
        sumADC += hit.SummedADC();
      } // itt
      // get the wire, plane from a hit
      unsigned int iht = clstr.tclhits[0];

      geo::View_t view = FinalHits->at(iht).View();
      sccol.emplace_back((float)clstr.BeginWir, // Start wire
                         0,                     // sigma start wire
                         clstr.BeginTim,        // start tick
                         0,                     // sigma start tick
                         clstr.BeginChg,        // start charge
                         clstr.BeginAng,        // start angle
                         0,                     // start opening angle (0 for line-like clusters)
                         (float)clstr.EndWir,   // end wire
                         0,                     // sigma end wire
                         clstr.EndTim,          // end tick
                         0,                     // sigma end tick
                         clstr.EndChg,          // end charge
                         clstr.EndAng,          // end angle
                         0,                     // end opening angle (0 for line-like clusters)
                         sumChg,                // integral
                         0,                     // sigma integral
                         sumADC,                // summed ADC
                         0,                     // sigma summed ADC
                         nclhits,               // n hits
                         0,                     // wires over hits
                         0,                     // width (0 for line-like clusters)
                         clsID,                 // ID
                         view,                  // view
                         planeID,               // plane
                         recob::Cluster::Sentry // sentry
      );
      // make the cluster - hit association
      if (!util::CreateAssn(
            *this, evt, *hc_assn, sccol.size() - 1, clstr.tclhits.begin(), clstr.tclhits.end())) {
        throw art::Exception(art::errors::ProductRegistrationFailure)
          << "Failed to associate hit " << iht << " with cluster " << icl;
      } // exception
      // make the cluster - endpoint associations
      if (clstr.BeginVtx >= 0) {
        end = 0;
        // See if this endpoint is associated with a 3D vertex
        unsigned short vtxIndex = 0;
        for (ClusterCrawlerAlg::Vtx3Store const& vtx3 : Vertices) {
          // ignore incomplete vertices
          if (vtx3.Ptr2D[0] < 0) continue;
          if (vtx3.Ptr2D[1] < 0) continue;
          if (vtx3.Ptr2D[2] < 0) continue;
          if (vtx3.Ptr2D[plane] == clstr.BeginVtx) {
            if (!util::CreateAssnD(*this, evt, *cv_assn, clsID - 1, vtxIndex, end)) {
              throw art::Exception(art::errors::ProductRegistrationFailure)
                << "Failed to associate cluster " << icl << " with vertex";
            } // exception
            break;
          } // vertex match
          ++vtxIndex;
        } // 3D vertices
      }   // clstr.BeginVtx >= 0
      if (clstr.EndVtx >= 0) {
        end = 1;
        // See if this endpoint is associated with a 3D vertex
        unsigned short vtxIndex = 0;
        for (ClusterCrawlerAlg::Vtx3Store const& vtx3 : Vertices) {
          // ignore incomplete vertices
          if (vtx3.Ptr2D[0] < 0) continue;
          if (vtx3.Ptr2D[1] < 0) continue;
          if (vtx3.Ptr2D[2] < 0) continue;
          if (vtx3.Ptr2D[plane] == clstr.EndVtx) {
            if (!util::CreateAssnD(*this, evt, *cv_assn, clsID - 1, vtxIndex, end)) {
              throw art::Exception(art::errors::ProductRegistrationFailure)
                << "Failed to associate cluster " << icl << " with endpoint";
            } // exception
            break;
          } // vertex match
          ++vtxIndex;
        } // 3D vertices
      }   // clstr.BeginVtx >= 0
    }     // icl

    // convert cluster vector to unique_ptrs
    std::unique_ptr<std::vector<recob::Cluster>> ccol(
      new std::vector<recob::Cluster>(std::move(sccol)));

    shcol.use_hits(std::move(FinalHits));

    // clean up
    fCCAlg.ClearResults();

    // move the hit collection and the associations into the event:
    shcol.put_into(evt);
    evt.put(std::move(ccol));
    evt.put(std::move(hc_assn));
    evt.put(std::move(v3col));
    evt.put(std::move(cv_assn));

  } // produce

Member Data Documentation

std::string cluster::ClusterCrawler::fCalDataModuleLabel

private

label of module producing input wires

Definition at line 48 of file ClusterCrawler_module.cc.

ClusterCrawlerAlg cluster::ClusterCrawler::fCCAlg

private

Definition at line 47 of file ClusterCrawler_module.cc.

hit::CCHitFinderAlg cluster::ClusterCrawler::fCCHFAlg

private

Definition at line 46 of file ClusterCrawler_module.cc.

---

The documentation for this class was generated from the following file:

• larreco/larreco/ClusterFinder/ClusterCrawler_module.cc