cluster::ClusterMatchAlg Class Reference

#include "ClusterMatchAlg.h"

Classes
struct	cluster_match_info

Public Types
enum	MatchMethod_t {   kRoughZ = 0, kRoughT, kSpacePoint, kSumCharge,   kMATCH_METHOD_MAX }
	Enum switch for various matching methods. More...

Public Member Functions
	ClusterMatchAlg (fhicl::ParameterSet const &pset)
	Default constructor with fhicl parameters. More...
virtual	~ClusterMatchAlg ()
	Default destructor. More...
void	ReportConfig () const
	Method to report the current configuration. More...
void	SetMCTruthModName (std::string name)
	Method to specify input MCTruth's module name (optional) More...
void	FillMCInfo (const art::Event &evt)
	Internal method to fill MCTruth information when available. More...
void	AppendClusterInfo (const recob::Cluster &in_cluster, const std::vector< art::Ptr< recob::Hit > > &in_hit_v)
	Method to fill cluster information to be used for matching. More...
void	AppendClusterInfo (const art::Ptr< recob::Cluster > in_cluster, const std::vector< art::Ptr< recob::Hit > > &in_hit_v)
	Method to fill cluster information to be used for matching. More...
void	MatchThreePlanes ()
void	MatchTwoPlanes ()
	Two plane version of cluster matching method. More...
std::vector< std::vector< unsigned int > >	GetMatchedClusters () const
	Method to retrieve matched cluster combinations. The format is [wire_plane][cluster_index]. More...
const std::vector< std::vector< recob::SpacePoint > > &	GetMatchedSpacePoints () const
	Method to retrieve matched SpacePoint for each combinations. More...
bool	StoreSpacePoints () const
	Method to check if it is configured to store SpacePoint. More...
void	ClearEventInfo ()
	Method to clear event-wise information. More...

Protected Member Functions
void	ClearMatchInputInfo ()
	Method to clear input cluster information. More...
void	ClearMatchOutputInfo ()
	Method to clear output matched cluster information. More...
void	ClearTTreeInfo ()
	Method to clear TTree variables. More...
void	PrepareDetParams ()
	Internal method, called only once, to fill detector-wise information. More...
void	PrepareTTree ()
	Internal method to create output TTree for quality checking of the algorithm. More...
void	FillHitInfo (cluster_match_info &ci, art::PtrVector< recob::Hit > &out_hit_v, const std::vector< art::Ptr< recob::Hit > > &in_hit_v)
void	AppendClusterTreeVariables (const cluster_match_info &ci)
	Internal method to fill cluster-info tree. More...
bool	Match_RoughZ (const cluster_match_info &ci1, const cluster_match_info &ci2, const geo::View_t v1, const geo::View_t v2) const
bool	Match_RoughTime (const cluster_match_info &ci1, const cluster_match_info &ci2)
	Checks min/max hit timing among two clusters and make sure there is an overlap. More...
bool	Match_SumCharge (const cluster_match_info &uc, const cluster_match_info &vc)
bool	Match_SpacePoint (const size_t uindex, const size_t vindex, const size_t windex, std::vector< recob::SpacePoint > &sps_v)

Protected Attributes
size_t	_num_sps_cut
	Number of SpacePoint used to cut in Match_SpacePoint method. More...
double	_overlay_tratio_cut
	Minimum overlayed time fraction among two clusters used in Match_RoughTime method. More...
double	_qratio_cut
	Maximum difference among clusters' charge sum used in Match_SumCharge method. More...
std::vector< unsigned int >	_matched_uclusters_v
	U plane matched clusters' index. More...
std::vector< unsigned int >	_matched_vclusters_v
	V plane matched clusters' index. More...
std::vector< unsigned int >	_matched_wclusters_v
	W plane matched clusters' index. More...
std::vector< std::vector< recob::SpacePoint > >	_matched_sps_v
	Local SpacePoint vector container. More...
bool	_match_methods [kMATCH_METHOD_MAX]
	Boolean list for enabled algorithms. More...
bool	_det_params_prepared
bool	_debug_mode
	Boolean to enable debug mode (call all enabled matching methods) More...
bool	_store_sps
	Boolean to enable storage of SpacePoint vector. More...
unsigned int	_tot_planes
double	_time_offset_uplane
double	_time_offset_vplane
double	_time_offset_wplane
std::string	_ModName_MCTruth
	MCTruth producer's module name. More...
std::vector< art::PtrVector< recob::Hit > >	_uhits_v
	Local Hit pointer vector container ... U-plane. More...
std::vector< art::PtrVector< recob::Hit > >	_vhits_v
	Local Hit pointer vector container ... V-plane. More...
std::vector< art::PtrVector< recob::Hit > >	_whits_v
	Local Hit pointer vector container ... W-plane. More...
std::vector< cluster_match_info >	_ucluster_v
	Local cluster data container... U-plane. More...
std::vector< cluster_match_info >	_vcluster_v
	Local cluster data container... V-plane. More...
std::vector< cluster_match_info >	_wcluster_v
	Local cluster data container... W-plane. More...
trkf::SpacePointAlg *	_sps_algo
	SpacePointFinder algorithm pointer. More...
TTree *	_match_tree
double	_mc_E
double	_mc_Px
double	_mc_Py
double	_mc_Pz
double	_mc_Vx
double	_mc_Vy
double	_mc_Vz
int	_pdgid
unsigned short	_tot_u
unsigned short	_tot_v
unsigned short	_tot_w
unsigned short	_tot_pass_qsum
unsigned short	_tot_pass_t
unsigned short	_tot_pass_z
unsigned short	_tot_pass_sps
std::vector< uint16_t >	_u_nhits_v
std::vector< uint16_t >	_v_nhits_v
std::vector< uint16_t >	_w_nhits_v
std::vector< uint16_t >	_nsps
std::vector< double >	_qratio_v
std::vector< double >	_uv_tratio_v
std::vector< double >	_vw_tratio_v
std::vector< double >	_wu_tratio_v
bool	_save_cluster_info
TTree *	_cluster_tree
std::vector< uint16_t >	_view_v
std::vector< double >	_charge_v
std::vector< uint16_t >	_nhits_v
std::vector< double >	_tstart_min_v
std::vector< double >	_tstart_max_v
std::vector< double >	_tpeak_min_v
std::vector< double >	_tpeak_max_v
std::vector< double >	_tend_min_v
std::vector< double >	_tend_max_v

Detailed Description

Definition at line 44 of file ClusterMatchAlg.h.

Member Enumeration Documentation

enum cluster::ClusterMatchAlg::MatchMethod_t

Enum switch for various matching methods.

Enumerator
kRoughZ	Rough-Z comparison method ... see Match_RoughZ() description.
kRoughT	Rough-Time comparison method ... see Match_RoughTime() description.
kSpacePoint	Use SpacePoint finder algorithm ... see Match_SpacePoint() description.
kSumCharge	Use summed charge comparison ... see Match_SumCharge() description.
kMATCH_METHOD_MAX

Definition at line 49 of file ClusterMatchAlg.h.

                       { kRoughZ = 0,      
                         kRoughT,          
                         kSpacePoint,      
                         kSumCharge,       
                         kMATCH_METHOD_MAX 
    };

Constructor & Destructor Documentation

cluster::ClusterMatchAlg::ClusterMatchAlg

(

fhicl::ParameterSet const &

pset

)

Default constructor with fhicl parameters.

Definition at line 15 of file ClusterMatchAlg.cxx.

References _cluster_tree, _debug_mode, _det_params_prepared, _match_methods, _match_tree, _num_sps_cut, _overlay_tratio_cut, _qratio_cut, _save_cluster_info, _sps_algo, _store_sps, ClearEventInfo(), fhicl::ParameterSet::get(), kMATCH_METHOD_MAX, and ReportConfig().

Referenced by cluster::ClusterMatchAlg::cluster_match_info::cluster_match_info().

                                                               :
    _ModName_MCTruth("")
  //##################################################################
  {    

    _debug_mode         = pset.get<bool>   ("DebugMode");
    _store_sps          = pset.get<bool>   ("StoreSpacePoint");
    _num_sps_cut        = pset.get<size_t> ("CutParam_NumSpacePoint");
    _overlay_tratio_cut = pset.get<double> ("CutParam_OverlayTimeFraction");
    _qratio_cut         = pset.get<double> ("CutParam_SumChargeRatio");
    std::vector<size_t> algo_list = pset.get<std::vector<size_t> > ("MatchAlgoList");

    _sps_algo = new trkf::SpacePointAlg(pset.get<fhicl::ParameterSet>("SpacePointAlg"));
    _match_tree = 0;
    _cluster_tree = 0;
    _save_cluster_info = true;
    _det_params_prepared = false;

    for(size_t i=0; i<(size_t)(kMATCH_METHOD_MAX); ++i)

      _match_methods[i]=false;

    for(auto const v : algo_list) {

      if(v >= (size_t)(kMATCH_METHOD_MAX))

        mf::LogError("ClusterMatchAlg")<<Form("Invalid algorithm enum: %zu",v);
      
      else _match_methods[v]=true;
    }

    ReportConfig();

    ClearEventInfo();
  }

virtual cluster::ClusterMatchAlg::~ClusterMatchAlg ( )

inlinevirtual

Default destructor.

Definition at line 104 of file ClusterMatchAlg.h.

References ReportConfig().

{};

Member Function Documentation

void cluster::ClusterMatchAlg::AppendClusterInfo	(	const recob::Cluster &	in_cluster,
		const std::vector< art::Ptr< recob::Hit > > &	in_hit_v
	)

Method to fill cluster information to be used for matching.

Definition at line 266 of file ClusterMatchAlg.cxx.

References _ucluster_v, _uhits_v, _vcluster_v, _vhits_v, _wcluster_v, _whits_v, AppendClusterTreeVariables(), FillHitInfo(), recob::Cluster::ID(), geo::kU, geo::kV, geo::kW, PrepareDetParams(), cluster::ClusterMatchAlg::cluster_match_info::view, and recob::Cluster::View().

Referenced by SetMCTruthModName().

                                                                                        {

    PrepareDetParams();
    cluster_match_info ci(in_cluster.ID());
    ci.view = in_cluster.View();

    art::PtrVector<recob::Hit> hit_ptrv;
    FillHitInfo(ci, hit_ptrv, in_hit_v);

    // Save created art::PtrVector & cluster_match_info struct object
    switch(ci.view){
    case geo::kU:
      _uhits_v.push_back(hit_ptrv);
      _ucluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    case geo::kV:
      _vhits_v.push_back(hit_ptrv);
      _vcluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    case geo::kW:
      _whits_v.push_back(hit_ptrv);
      _wcluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    default:
      mf::LogError("ClusterMatchAlg")<<Form("Found an invalid plane ID: %d",in_cluster.View());
    }
    
  }

void cluster::ClusterMatchAlg::AppendClusterInfo	(	const art::Ptr< recob::Cluster >	in_cluster,
		const std::vector< art::Ptr< recob::Hit > > &	in_hit_v
	)

Method to fill cluster information to be used for matching.

Definition at line 299 of file ClusterMatchAlg.cxx.

References _ucluster_v, _uhits_v, _vcluster_v, _vhits_v, _wcluster_v, _whits_v, AppendClusterTreeVariables(), FillHitInfo(), recob::Cluster::ID(), geo::kU, geo::kV, geo::kW, PrepareDetParams(), cluster::ClusterMatchAlg::cluster_match_info::view, and recob::Cluster::View().

                                                                                        {

    PrepareDetParams();
    cluster_match_info ci(in_cluster->ID());
    ci.view = in_cluster->View();

    art::PtrVector<recob::Hit> hit_ptrv;
    FillHitInfo(ci, hit_ptrv, in_hit_v);

    // Save created art::PtrVector & cluster_match_info struct object                                                                       
    switch(ci.view){
    case geo::kU:
      _uhits_v.push_back(hit_ptrv);
      _ucluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    case geo::kV:
      _vhits_v.push_back(hit_ptrv);
      _vcluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    case geo::kW:
      _whits_v.push_back(hit_ptrv);
      _wcluster_v.push_back(ci);
      AppendClusterTreeVariables(ci);
      break;
    default:
      mf::LogError("ClusterMatchAlg")<<Form("Found an invalid plane ID: %d",in_cluster->View());
    }

  }

void cluster::ClusterMatchAlg::AppendClusterTreeVariables ( const cluster_match_info &  ci )

protected

Internal method to fill cluster-info tree.

Definition at line 373 of file ClusterMatchAlg.cxx.

References _charge_v, _cluster_tree, _nhits_v, _tend_max_v, _tend_min_v, _tpeak_max_v, _tpeak_min_v, _tstart_max_v, _tstart_min_v, _view_v, cluster::ClusterMatchAlg::cluster_match_info::end_time_max, cluster::ClusterMatchAlg::cluster_match_info::end_time_min, cluster::ClusterMatchAlg::cluster_match_info::nhits, cluster::ClusterMatchAlg::cluster_match_info::peak_time_max, cluster::ClusterMatchAlg::cluster_match_info::peak_time_min, cluster::ClusterMatchAlg::cluster_match_info::start_time_max, cluster::ClusterMatchAlg::cluster_match_info::start_time_min, cluster::ClusterMatchAlg::cluster_match_info::sum_charge, and cluster::ClusterMatchAlg::cluster_match_info::view.

Referenced by AppendClusterInfo(), and StoreSpacePoints().

  {

    if(_cluster_tree){
      _view_v.push_back(ci.view);
      _charge_v.push_back(ci.sum_charge);
      _nhits_v.push_back(ci.nhits);
      _tstart_min_v.push_back(ci.start_time_min);
      _tstart_max_v.push_back(ci.start_time_max);
      _tpeak_min_v.push_back(ci.peak_time_min);
      _tpeak_max_v.push_back(ci.peak_time_max);
      _tend_min_v.push_back(ci.end_time_min);
      _tend_max_v.push_back(ci.end_time_max);
    }

  }

void cluster::ClusterMatchAlg::ClearEventInfo

(

)

Method to clear event-wise information.

Clear TTree variables

Definition at line 137 of file ClusterMatchAlg.cxx.

References ClearMatchInputInfo(), ClearMatchOutputInfo(), and ClearTTreeInfo().

Referenced by ClusterMatchAlg(), and StoreSpacePoints().

  {
    // Clear input event data holders
    ClearMatchInputInfo();

    // Clear result data holders
    ClearMatchOutputInfo();

    ClearTTreeInfo();

  }

void cluster::ClusterMatchAlg::ClearMatchInputInfo ( )

protected

Method to clear input cluster information.

Definition at line 78 of file ClusterMatchAlg.cxx.

References _ucluster_v, _uhits_v, _vcluster_v, _vhits_v, _wcluster_v, and _whits_v.

Referenced by ClearEventInfo(), MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    _ucluster_v.clear();
    _vcluster_v.clear();
    _wcluster_v.clear();
    
    _uhits_v.clear();
    _vhits_v.clear();
    _whits_v.clear();
  }

void cluster::ClusterMatchAlg::ClearMatchOutputInfo ( )

protected

Method to clear output matched cluster information.

Definition at line 89 of file ClusterMatchAlg.cxx.

References _matched_sps_v, _matched_uclusters_v, _matched_vclusters_v, and _matched_wclusters_v.

Referenced by ClearEventInfo(), MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    _matched_uclusters_v.clear();
    _matched_vclusters_v.clear();
    _matched_wclusters_v.clear();
    _matched_sps_v.clear();
  }

void cluster::ClusterMatchAlg::ClearTTreeInfo ( )

protected

Method to clear TTree variables.

Definition at line 97 of file ClusterMatchAlg.cxx.

References _charge_v, _mc_E, _mc_Px, _mc_Py, _mc_Pz, _mc_Vx, _mc_Vy, _mc_Vz, _nhits_v, _nsps, _pdgid, _qratio_v, _tend_max_v, _tend_min_v, _tot_pass_qsum, _tot_pass_sps, _tot_pass_t, _tot_pass_z, _tot_u, _tot_v, _tot_w, _tpeak_max_v, _tpeak_min_v, _tstart_max_v, _tstart_min_v, _u_nhits_v, _uv_tratio_v, _v_nhits_v, _view_v, _vw_tratio_v, _w_nhits_v, and _wu_tratio_v.

Referenced by ClearEventInfo(), MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {

    _mc_E  = 0;
    _mc_Px = 0;
    _mc_Py = 0;
    _mc_Pz = 0;
    _mc_Vx = 0;
    _mc_Vy = 0;
    _mc_Vz = 0;
    _pdgid = 0;
    _tot_u = 0;
    _tot_v = 0;
    _tot_w = 0;
    _tot_pass_z = 0;
    _tot_pass_t = 0;
    _tot_pass_sps = 0;
    _tot_pass_qsum = 0;
    _qratio_v.clear();
    _uv_tratio_v.clear();
    _vw_tratio_v.clear();
    _wu_tratio_v.clear();
    _u_nhits_v.clear();
    _v_nhits_v.clear();
    _w_nhits_v.clear();
    _nsps.clear();

    _view_v.clear();
    _charge_v.clear();
    _nhits_v.clear();
    _tstart_min_v.clear();
    _tstart_max_v.clear();
    _tpeak_min_v.clear();
    _tpeak_max_v.clear();
    _tend_min_v.clear();
    _tend_max_v.clear();   

  }

void cluster::ClusterMatchAlg::FillHitInfo ( cluster_match_info &  ci, art::PtrVector< recob::Hit > &  out_hit_v, const std::vector< art::Ptr< recob::Hit > > &  in_hit_v  )

protected

Definition at line 334 of file ClusterMatchAlg.cxx.

References _time_offset_uplane, _time_offset_vplane, _time_offset_wplane, cluster::ClusterMatchAlg::cluster_match_info::end_time_max, cluster::ClusterMatchAlg::cluster_match_info::end_time_min, geo::kU, geo::kV, geo::kW, cluster::ClusterMatchAlg::cluster_match_info::nhits, cluster::ClusterMatchAlg::cluster_match_info::peak_time_max, cluster::ClusterMatchAlg::cluster_match_info::peak_time_min, art::PtrVector< T >::push_back(), art::PtrVector< T >::reserve(), cluster::ClusterMatchAlg::cluster_match_info::start_time_max, cluster::ClusterMatchAlg::cluster_match_info::start_time_min, cluster::ClusterMatchAlg::cluster_match_info::sum_charge, cluster::ClusterMatchAlg::cluster_match_info::view, cluster::ClusterMatchAlg::cluster_match_info::wire_max, and cluster::ClusterMatchAlg::cluster_match_info::wire_min.

Referenced by AppendClusterInfo(), and StoreSpacePoints().

  {

    out_hit_v.reserve(in_hit_v.size());
    
    double time_offset = 0;
    if(ci.view == geo::kU) time_offset = _time_offset_uplane;
    else if(ci.view == geo::kV) time_offset = _time_offset_vplane;
    else if(ci.view == geo::kW) time_offset = _time_offset_wplane;

    // Loop over hits in this cluster
    for(auto const hit : in_hit_v){

      unsigned int wire = hit->WireID().Wire;
      double tstart = hit->PeakTimePlusRMS(-1.) - time_offset;
      double tpeak = hit->PeakTime() - time_offset;
      double tend = hit->PeakTimePlusRMS(+1.) - time_offset;

      ci.sum_charge += hit->Integral();
      
      ci.wire_max = (ci.wire_max < wire) ? wire : ci.wire_max;
      ci.wire_min = (ci.wire_min > wire) ? wire : ci.wire_min;
      
      ci.start_time_max = ( ci.start_time_max < tstart ) ? tstart : ci.start_time_max;
      ci.peak_time_max  = ( ci.peak_time_max  < tpeak  ) ? tpeak  : ci.peak_time_max;
      ci.end_time_max   = ( ci.end_time_max   < tend   ) ? tend   : ci.end_time_max;
      
      ci.start_time_min = ( ci.start_time_min > tstart) ? tstart : ci.start_time_min;
      ci.peak_time_min  = ( ci.peak_time_min  > tpeak)  ? tpeak  : ci.peak_time_min;
      ci.end_time_min   = ( ci.end_time_min   > tend)   ? tend   : ci.end_time_min;
      
      out_hit_v.push_back(hit);
    }
    
    ci.nhits = in_hit_v.size();
  }

void cluster::ClusterMatchAlg::FillMCInfo

(

const art::Event &

evt

)

Internal method to fill MCTruth information when available.

Definition at line 201 of file ClusterMatchAlg.cxx.

References _mc_E, _mc_Px, _mc_Py, _mc_Pz, _mc_Vx, _mc_Vy, _mc_Vz, _ModName_MCTruth, _pdgid, e, art::DataViewImpl::getView(), part, and art::errors::ProductNotFound.

Referenced by SetMCTruthModName().

  {
    if(!_ModName_MCTruth.size()) return;

    std::vector<const simb::MCTruth*> mciArray;

    try {

      evt.getView(_ModName_MCTruth,mciArray);

    }catch (art::Exception const& e) {

      if (e.categoryCode() != art::errors::ProductNotFound ) throw;

    }

    for(size_t i=0; i < mciArray.size(); ++i){
      
      if(i==1) {
        mf::LogWarning("ClusterMatchAlg")<<" Ignoring > 2nd MCTruth in MC generator...";
        break;
      }
      const simb::MCTruth* mci_ptr(mciArray.at(i));

      for(size_t j=0; j < (size_t)(mci_ptr->NParticles()); ++j){

        if(j==1) {
          mf::LogWarning("ClusterMatchAlg")<<" Ignoring > 2nd MCParticle in MC generator...";
          break;
        }

        const simb::MCParticle part(mci_ptr->GetParticle(j));
        
        _pdgid = part.PdgCode();
        _mc_E  = part.E();
        _mc_Px = part.Px();
        _mc_Py = part.Py();
        _mc_Pz = part.Pz();
        _mc_Vx = part.Vx();
        _mc_Vy = part.Vy();
        _mc_Vz = part.Vz();
      }
    }
  }

std::vector< std::vector< unsigned int > > cluster::ClusterMatchAlg::GetMatchedClusters

(

)

const

Method to retrieve matched cluster combinations. The format is [wire_plane][cluster_index].

Definition at line 523 of file ClusterMatchAlg.cxx.

References _matched_uclusters_v, _matched_vclusters_v, and _matched_wclusters_v.

Referenced by SetMCTruthModName().

  {
    std::vector<std::vector<unsigned int> > result;
    result.push_back(_matched_uclusters_v);
    result.push_back(_matched_vclusters_v);
    result.push_back(_matched_wclusters_v);
    return result;
  }

const std::vector<std::vector<recob::SpacePoint> >& cluster::ClusterMatchAlg::GetMatchedSpacePoints ( ) const

inline

Method to retrieve matched SpacePoint for each combinations.

Definition at line 139 of file ClusterMatchAlg.h.

References _matched_sps_v.

{ return _matched_sps_v; };

bool cluster::ClusterMatchAlg::Match_RoughTime ( const cluster_match_info &  ci1, const cluster_match_info &  ci2  )

protected

Checks min/max hit timing among two clusters and make sure there is an overlap.

Definition at line 404 of file ClusterMatchAlg.cxx.

References _overlay_tratio_cut, _uv_tratio_v, _vw_tratio_v, _wu_tratio_v, cluster::ClusterMatchAlg::cluster_match_info::end_time_max, geo::kU, geo::kV, geo::kW, max, min, cluster::ClusterMatchAlg::cluster_match_info::start_time_min, and cluster::ClusterMatchAlg::cluster_match_info::view.

Referenced by MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    //return (!(ci1.end_time_max < ci2.start_time_min || ci2.end_time_max < ci1.start_time_min));
    double time_overlay = std::min(ci1.end_time_max,ci2.end_time_max) - std::max(ci1.start_time_min,ci2.start_time_min);

    //if(time_overlay <= 0 && !_debug_mode) return false;

    double overlay_tratio = time_overlay /  (ci1.end_time_max - ci1.start_time_min + ci2.end_time_max - ci2.start_time_min) * 2.;
    
    if( (ci1.view==geo::kU && ci2.view==geo::kV) || (ci1.view==geo::kV && ci2.view==geo::kU) )
      _uv_tratio_v.push_back(overlay_tratio);
    else if( (ci1.view==geo::kV && ci2.view==geo::kW) || (ci1.view==geo::kW && ci2.view==geo::kV) )
      _vw_tratio_v.push_back(overlay_tratio);
    else if( (ci1.view==geo::kW && ci2.view==geo::kU) || (ci1.view==geo::kU && ci2.view==geo::kW) )
      _wu_tratio_v.push_back(overlay_tratio);

    return (overlay_tratio > _overlay_tratio_cut);
  }

bool cluster::ClusterMatchAlg::Match_RoughZ ( const cluster_match_info &  ci1, const cluster_match_info &  ci2, const geo::View_t  v1, const geo::View_t  v2  ) const

protected

Match clusters based on min/max Z boundary information. It checks clusters' overlap along Z spatial coordinate based on 2 input cluster information.

Definition at line 391 of file ClusterMatchAlg.cxx.

References geo::GeometryCore::IntersectionPoint(), and y.

Referenced by MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    art::ServiceHandle<geo::Geometry> geo_h;
    double y, z_min, z_max;
    y = z_min = z_max = -1;
    geo_h->IntersectionPoint(ci1.wire_min, ci2.wire_min, v1, v2, 0, 0, y, z_min);
    geo_h->IntersectionPoint(ci1.wire_max, ci2.wire_max, v1, v2, 0, 0, y, z_max);
    return (z_max > z_min);
  }

bool cluster::ClusterMatchAlg::Match_SpacePoint ( const size_t  uindex, const size_t  vindex, const size_t  windex, std::vector< recob::SpacePoint > &  sps_v  )

protected

Cluster matching using space points. This can be slow as we run SpacePointFinder algorithm per cluster pair. Three clusters (U, V, W) are considerd to "match" if there found N spacepoints using hits in them and N > min_nsps where "min_nsps" is the cut value you can set in SetNSpacePointCut() method.

Definition at line 437 of file ClusterMatchAlg.cxx.

References _debug_mode, _nsps, _num_sps_cut, _sps_algo, _tot_planes, _u_nhits_v, _ucluster_v, _uhits_v, _v_nhits_v, _vcluster_v, _vhits_v, _w_nhits_v, _wcluster_v, _whits_v, trkf::SpacePointAlg::clearHitMap(), trkf::SpacePointAlg::makeSpacePoints(), max, trkf::SpacePointAlg::maxDT(), min, art::PtrVector< T >::push_back(), art::PtrVector< T >::reserve(), and art::PtrVector< T >::size().

Referenced by MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    bool use_wplane = _tot_planes > 2;

    if( uindex >= _ucluster_v.size() ||
        vindex >= _vcluster_v.size() ||
        (use_wplane && (windex >= _wcluster_v.size())) ) {
      
      mf::LogError("ClusterMatchAlg")
        << std::endl
        << Form("Requested to cluster-index (U,V,W) = (%zu,%zu,%zu) where max-length is (%zu,%zu,%zu)",
                uindex, vindex, windex, _ucluster_v.size(), _vcluster_v.size(), _wcluster_v.size())
        << std::endl;
      return false;
    }

    // Define a time range in which hits are used for spacepoint finding ... here "peak time" is the relevant one
    double trange_min = std::min(_ucluster_v.at(uindex).peak_time_min,_vcluster_v.at(vindex).peak_time_min);
    if(use_wplane) trange_min = std::min(trange_min, _wcluster_v.at(windex).peak_time_min);

    double trange_max = std::max(_ucluster_v.at(uindex).peak_time_max,_vcluster_v.at(vindex).peak_time_max);
    if(use_wplane) trange_max = std::max(trange_max,_wcluster_v.at(windex).peak_time_max);
    
    // Space-point algorithm applies additional dT
    trange_min -= _sps_algo->maxDT();
    trange_max += _sps_algo->maxDT();
    
    // Make PtrVector<recob::Hit> for relevant Hits
    art::PtrVector<recob::Hit> hit_group;
    size_t max_size = _uhits_v.at(uindex).size() + _vhits_v.at(vindex).size();
    if(use_wplane) max_size += _whits_v.at(windex).size();
    hit_group.reserve(max_size);
    // Loop over hits in U-plane
    for(auto const hit : _uhits_v.at(uindex)) {
      if(hit->PeakTime() < trange_min) continue;
      if(hit->PeakTime() > trange_max) continue;
      hit_group.push_back(hit);
    }
    // Check if any hit found in this plane
    size_t u_nhits = hit_group.size();
    if( !u_nhits && !_debug_mode) return false;
    // Loop over hits in V-plane
    for(auto const hit: _vhits_v.at(vindex)) {
      if(hit->PeakTime() < trange_min) continue;
      if(hit->PeakTime() > trange_max) continue;
      hit_group.push_back(hit);
    }
    // Check if any hit found in this plane
    size_t v_nhits = hit_group.size() - u_nhits;
    if( !(v_nhits) && !_debug_mode) return false;
    
    // Loop over hits in W-plane
    if(use_wplane) {
      for(auto const hit: _whits_v.at(windex)) {
        if(hit->PeakTime() < trange_min) continue;
        if(hit->PeakTime() > trange_max) continue;
        hit_group.push_back(hit);
      }
    }
    // Check if any hit found in this plane
    size_t w_nhits = hit_group.size() - u_nhits - v_nhits;
    if( !(w_nhits) && use_wplane && !_debug_mode) return false;

    // Run SpacePoint finder algo
    if(u_nhits && v_nhits && 
       (!use_wplane || (w_nhits && use_wplane))) {
      _sps_algo->clearHitMap();
      _sps_algo->makeSpacePoints(hit_group,sps_v);
    }

    size_t nsps = sps_v.size();
    _u_nhits_v.push_back(u_nhits);
    _v_nhits_v.push_back(v_nhits);
    if(use_wplane)
      _w_nhits_v.push_back(w_nhits); 
    _nsps.push_back(nsps);

    if( nsps < _num_sps_cut ) return false;
    return true;
  }

bool cluster::ClusterMatchAlg::Match_SumCharge ( const cluster_match_info &  uc, const cluster_match_info &  vc  )

protected

Checks min/max hit timing among three clusters and make sure there is an overlap. If _overlay_tratio_cut is set, then overlapped-time / cluster-timespan fraction is compared to the set cut value to claim a match. Checks the ratio of two clusters' summed charge. If the ratio is within 1 +/- set cut value, two clusters are considered to match.

Definition at line 425 of file ClusterMatchAlg.cxx.

References _qratio_cut, _qratio_v, and cluster::ClusterMatchAlg::cluster_match_info::sum_charge.

Referenced by MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    double qratio = (uc.sum_charge)/(vc.sum_charge);
    
    // For quality check log
    _qratio_v.push_back(qratio);

    return ( (1 - _qratio_cut) < qratio && (qratio) < (1 + _qratio_cut) );
  }

void cluster::ClusterMatchAlg::MatchThreePlanes

(

)

Method to run matching algorithms for three planes. Event info must be provided prior to this function call through FillEventInfo() function call. If the function is called more than once w/o supplying the new art::Event object, it does not perform any new matching unless a user explicitly calls ClearEventInfo() and then fill event info again though FillEventInfo().

Clear TTree variables

Definition at line 637 of file ClusterMatchAlg.cxx.

References _cluster_tree, _debug_mode, _match_methods, _match_tree, _matched_sps_v, _matched_uclusters_v, _matched_vclusters_v, _matched_wclusters_v, _store_sps, _tot_pass_qsum, _tot_pass_sps, _tot_pass_t, _tot_pass_z, _tot_u, _tot_v, _tot_w, _ucluster_v, _uhits_v, _vcluster_v, _vhits_v, _wcluster_v, _whits_v, ClearMatchInputInfo(), ClearMatchOutputInfo(), ClearTTreeInfo(), kRoughT, kRoughZ, kSpacePoint, kSumCharge, geo::kU, geo::kV, Match_RoughTime(), Match_RoughZ(), Match_SpacePoint(), Match_SumCharge(), and PrepareTTree().

Referenced by SetMCTruthModName().

  {
    std::ostringstream msg;
    msg << Form("Received (U,V,W) = (%zu,%zu,%zu) clusters...",
                _uhits_v.size(),
                _vhits_v.size(),
                _whits_v.size())
        << std::endl;
    _tot_u = _ucluster_v.size();
    _tot_v = _vcluster_v.size();
    _tot_w = _wcluster_v.size();

    if(!(_tot_u + _tot_v + _tot_w)) {
      
      mf::LogError(__PRETTY_FUNCTION__)<<"No input cluster info found! Aborting the function call...";

      return;
    }

    // Clear match information
    PrepareTTree();
    ClearMatchOutputInfo();

    bool overlay_2d=true;
    bool overlay_3d=true;
    // Loop over all possible u-v-w cluster combination
    for(size_t uci_index=0; uci_index<_ucluster_v.size(); ++uci_index) {

      for(size_t vci_index=0; vci_index<_vcluster_v.size(); ++vci_index) {

        // Apply cuts that can be done with U&V planes here
        overlay_2d = true;

        // Rough z-position overlay cut
        if(_match_methods[kRoughZ]) {

          if(Match_RoughZ(_ucluster_v.at(uci_index), _vcluster_v.at(vci_index), geo::kU, geo::kV))
            _tot_pass_z++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }

        // Sum charge cut
        if(_match_methods[kSumCharge]) {
          
          if(Match_SumCharge(_ucluster_v.at(uci_index),_vcluster_v.at(vci_index)))
            _tot_pass_qsum++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }

        for(size_t wci_index=0; wci_index<_wcluster_v.size(); ++wci_index) {

          overlay_3d = overlay_2d;
          // Apply cuts that requires 3 planes here

          // Rough time overlap cut
          if(_match_methods[kRoughT]) {
            
            bool rough_time_match = Match_RoughTime(_ucluster_v.at(uci_index), _vcluster_v.at(vci_index));
            if(!_debug_mode && !rough_time_match) continue;
            
            rough_time_match = (Match_RoughTime(_vcluster_v.at(vci_index), _wcluster_v.at(wci_index)) && rough_time_match);
            if(!_debug_mode && !rough_time_match) continue;
            
            rough_time_match = (Match_RoughTime(_wcluster_v.at(wci_index), _ucluster_v.at(uci_index)) && rough_time_match);

            overlay_3d = overlay_3d && rough_time_match;
            if(rough_time_match) _tot_pass_t++;
            else if(!_debug_mode) continue;
          }

          // SpacePoint cut
          std::vector<recob::SpacePoint> sps_v;
          if(_match_methods[kSpacePoint]) {

            if(Match_SpacePoint(uci_index, vci_index, wci_index, sps_v))
              _tot_pass_sps++;
            else if(!_debug_mode) continue; 
            else overlay_3d = false;
          }           

          if(overlay_3d) {
            _matched_uclusters_v.push_back((unsigned int)(_ucluster_v[uci_index].cluster_index));
            _matched_vclusters_v.push_back((unsigned int)(_vcluster_v[vci_index].cluster_index));
            _matched_wclusters_v.push_back((unsigned int)(_wcluster_v[wci_index].cluster_index));
            if(_store_sps)
              _matched_sps_v.push_back(sps_v);
          }
        } // end of ... _wcluster_v loop
      } // end of ... _vcluster_v loop
    } // end of ... _ucluster_v loop

    // Report
    msg << std::endl
        << Form("Found %zu matched cluster pairs...",_matched_uclusters_v.size()) 
        << std::endl;
    for(size_t i=0; i<_matched_uclusters_v.size(); ++i){

      if(i==0) msg << "Listing matched clusters (U,V,W)..." << std::endl;
      
      msg << Form("Pair %-2zu: (%-3d, %-3d, %-3d)",
                  i,
                  _matched_uclusters_v[i],
                  _matched_vclusters_v[i],
                  _matched_wclusters_v[i]) << std::endl;
      
    }
    msg << std::endl;
    mf::LogWarning("ClusterMatchAlg")<<msg.str();

    if(_match_tree)   _match_tree->Fill();
    if(_cluster_tree) _cluster_tree->Fill();
    // Clear input event data holders
    ClearMatchInputInfo();
    ClearTTreeInfo();

  }

void cluster::ClusterMatchAlg::MatchTwoPlanes

(

)

Two plane version of cluster matching method.

Clear TTree variables

Definition at line 534 of file ClusterMatchAlg.cxx.

References _cluster_tree, _debug_mode, _match_methods, _match_tree, _matched_sps_v, _matched_uclusters_v, _matched_vclusters_v, _store_sps, _tot_pass_qsum, _tot_pass_sps, _tot_pass_t, _tot_pass_z, _tot_u, _tot_v, _tot_w, _ucluster_v, _uhits_v, _vcluster_v, _vhits_v, _wcluster_v, _whits_v, ClearMatchInputInfo(), ClearMatchOutputInfo(), ClearTTreeInfo(), kRoughT, kRoughZ, kSpacePoint, kSumCharge, geo::kU, geo::kV, Match_RoughTime(), Match_RoughZ(), Match_SpacePoint(), Match_SumCharge(), and PrepareTTree().

Referenced by SetMCTruthModName().

  {
    std::ostringstream msg;
    msg << Form("Received (U,V,W) = (%zu,%zu,%zu) clusters...",
                _uhits_v.size(),
                _vhits_v.size(),
                _whits_v.size())
        << std::endl;
    _tot_u = _ucluster_v.size();
    _tot_v = _vcluster_v.size();
    _tot_w = _wcluster_v.size();

    if(!(_tot_u + _tot_v + _tot_w)) {
      
      mf::LogError(__PRETTY_FUNCTION__)<<"No input cluster info found! Aborting the function call...";

      return;
    }

    // Initialization
    PrepareTTree();
    ClearMatchOutputInfo();

    bool overlay_2d = false;
    for(size_t uci_index=0; uci_index<_ucluster_v.size(); ++uci_index) {

      for(size_t vci_index=0; vci_index<_vcluster_v.size(); ++vci_index) {

        overlay_2d = true;

        // Apply cuts
        // Rough z-position overlay cut
        if(_match_methods[kRoughZ]) {

          if(Match_RoughZ(_ucluster_v.at(uci_index), _vcluster_v.at(vci_index), geo::kU, geo::kV))
            _tot_pass_z++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }

                
        // Sum charge cut
        if(_match_methods[kSumCharge]) {
          
          if(Match_SumCharge(_ucluster_v.at(uci_index),_vcluster_v.at(vci_index)))
            _tot_pass_qsum++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }

        // Rough time overlap cut
        if(_match_methods[kRoughT]) {
          
          if(Match_RoughTime(_ucluster_v.at(uci_index), _vcluster_v.at(vci_index)))
            _tot_pass_t++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }

        // SpacePoint cut
        std::vector<recob::SpacePoint> sps_v;
        if(_match_methods[kSpacePoint]) {
          
          if(Match_SpacePoint(uci_index, vci_index, 0, sps_v)) 
            _tot_pass_sps++;
          else if(!_debug_mode) continue;
          else overlay_2d = false;
        }             
        
        if(overlay_2d) {
          _matched_uclusters_v.push_back((unsigned int)(_ucluster_v[uci_index].cluster_index));
          _matched_vclusters_v.push_back((unsigned int)(_vcluster_v[vci_index].cluster_index));
          if(_store_sps)
            _matched_sps_v.push_back(sps_v);
        }
      } // end of ... _vcluster_v loop
    } // end of ... _ucluster_v loop

    // Report
    msg << std::endl
        << Form("Found %zu matched cluster pairs...",_matched_uclusters_v.size()) 
        << std::endl;
    for(size_t i=0; i<_matched_uclusters_v.size(); ++i){

      if(i==0) msg << "Listing matched clusters (U,V)..." << std::endl;
      
      msg << Form("Pair %-2zu: (%-3d, %-3d)",i,_matched_uclusters_v[i],_matched_vclusters_v[i]) << std::endl;
      
    }
    msg << std::endl;
    mf::LogWarning("ClusterMatchAlg")<<msg.str();

    if(_match_tree)   _match_tree->Fill();
    if(_cluster_tree) _cluster_tree->Fill();

    // Clear input event data holders
    ClearMatchInputInfo();
    ClearTTreeInfo();
  }

void cluster::ClusterMatchAlg::PrepareDetParams ( )

protected

Internal method, called only once, to fill detector-wise information.

Definition at line 247 of file ClusterMatchAlg.cxx.

References _det_params_prepared, _time_offset_uplane, _time_offset_vplane, _time_offset_wplane, _tot_planes, detinfo::DetectorProperties::GetXTicksOffset(), geo::kU, geo::kV, geo::kW, and geo::GeometryCore::Nplanes().

Referenced by AppendClusterInfo(), and StoreSpacePoints().

  {
    if(!_det_params_prepared){
      // Total number of planes
      art::ServiceHandle<geo::Geometry> geo;
      _tot_planes = geo->Nplanes();
      
      // Ask DetectorPrperties about time-offset among different wire planes ... used to correct timing
      // difference among different wire planes in the following loop.
      const detinfo::DetectorProperties* det_h = lar::providerFrom<detinfo::DetectorPropertiesService>();
      _time_offset_uplane = det_h->GetXTicksOffset(geo::kU,0,0);
      _time_offset_vplane = det_h->GetXTicksOffset(geo::kV,0,0);
      _time_offset_wplane=0;
      if (_tot_planes >2 )
        _time_offset_wplane = det_h->GetXTicksOffset(geo::kW,0,0);
      _det_params_prepared = true;
    }
  }

void cluster::ClusterMatchAlg::PrepareTTree ( )

protected

Internal method to create output TTree for quality checking of the algorithm.

Definition at line 152 of file ClusterMatchAlg.cxx.

References _charge_v, _cluster_tree, _match_tree, _mc_E, _mc_Px, _mc_Py, _mc_Pz, _mc_Vx, _mc_Vy, _mc_Vz, _nhits_v, _nsps, _pdgid, _qratio_v, _save_cluster_info, _tend_max_v, _tend_min_v, _tot_pass_qsum, _tot_pass_sps, _tot_pass_t, _tot_pass_z, _tot_u, _tot_v, _tot_w, _tpeak_max_v, _tpeak_min_v, _tstart_max_v, _tstart_min_v, _u_nhits_v, _uv_tratio_v, _v_nhits_v, _view_v, _vw_tratio_v, _w_nhits_v, _wu_tratio_v, and art::TFileDirectory::make().

Referenced by MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

  {
    if(!_match_tree){
      art::ServiceHandle<art::TFileService> fileService;
      _match_tree = fileService->make<TTree>("match_tree","");
      _match_tree->Branch("mc_E",&_mc_E,"mc_E/D");
      _match_tree->Branch("mc_Px",&_mc_Px,"mc_Px/D");
      _match_tree->Branch("mc_Py",&_mc_Py,"mc_Py/D");
      _match_tree->Branch("mc_Pz",&_mc_Pz,"mc_Pz/D");
      _match_tree->Branch("mc_Vx",&_mc_Vx,"mc_Vx/D");
      _match_tree->Branch("mc_Vy",&_mc_Vy,"mc_Vy/D");
      _match_tree->Branch("mc_Vz",&_mc_Vz,"mc_Vz/D");

      _match_tree->Branch("pdgid",&_pdgid,"pdgid/I");
      _match_tree->Branch("tot_u",&_tot_u,"tot_u/s");
      _match_tree->Branch("tot_v",&_tot_v,"tot_v/s");
      _match_tree->Branch("tot_w",&_tot_w,"tot_w/s");
      _match_tree->Branch("tot_pass_t",&_tot_pass_t,"tot_pass_t/s");
      _match_tree->Branch("tot_pass_z",&_tot_pass_z,"tot_pass_z/s");
      _match_tree->Branch("tot_pass_sps",&_tot_pass_sps,"tot_pass_sps/s");
      _match_tree->Branch("tot_pass_qsum",&_tot_pass_qsum,"tot_pass_qsum/s");

      _match_tree->Branch("uv_tratio_v","std::vector<double>",&_uv_tratio_v);
      _match_tree->Branch("vw_tratio_v","std::vector<double>",&_vw_tratio_v);
      _match_tree->Branch("wu_tratio_v","std::vector<double>",&_wu_tratio_v);

      _match_tree->Branch("qratio_v", "std::vector<double>",&_qratio_v);
      _match_tree->Branch("u_nhits_v", "std::vector<UShort_t>",&_u_nhits_v);
      _match_tree->Branch("v_nhits_v", "std::vector<UShort_t>",&_v_nhits_v);
      _match_tree->Branch("w_nhits_v", "std::vector<UShort_t>",&_w_nhits_v);
      _match_tree->Branch("nsps",  "std::vector<UShort_t>",&_nsps);
    }
    if(_save_cluster_info && !_cluster_tree){
      art::ServiceHandle<art::TFileService> fileService;
      _cluster_tree = fileService->make<TTree>("cluster_tree","");
      _cluster_tree->Branch("view_v","std::vector<uint16_t>", &_view_v);
      _cluster_tree->Branch("charge_v","std::vector<double>", &_charge_v);
      _cluster_tree->Branch("nhits_v","std::vector<uint16_t>",&_nhits_v);
      _cluster_tree->Branch("tstart_min_v","std::vector<double>",&_tstart_min_v);
      _cluster_tree->Branch("tstart_max_v","std::vector<double>",&_tstart_max_v);
      _cluster_tree->Branch("tpeak_min_v","std::vector<double>",&_tpeak_min_v);
      _cluster_tree->Branch("tpeak_max_v","std::vector<double>",&_tpeak_max_v);
      _cluster_tree->Branch("tend_min_v","std::vector<double>",&_tend_min_v);
      _cluster_tree->Branch("tend_max_v","std::vector<double>",&_tend_max_v);
    }
  }

void cluster::ClusterMatchAlg::ReportConfig

(

)

const

Method to report the current configuration.

Definition at line 52 of file ClusterMatchAlg.cxx.

References _debug_mode, _match_methods, _num_sps_cut, _overlay_tratio_cut, _qratio_cut, kRoughT, kRoughZ, kSpacePoint, and kSumCharge.

Referenced by ClusterMatchAlg(), and ~ClusterMatchAlg().

  {
    std::ostringstream msg;
    msg
      << std::endl
      << " ClusterMatchAlg Configuration:              " << std::endl
      << "---------------------------------------------" << std::endl;
    msg << " Debug Mode ... " << (_debug_mode ? "enabled!" : "disabled!") << std::endl;
    msg << " RoughZ ....... " << (_match_methods[kRoughZ] ? "enabled!" : "disabled!") << std::endl;
    msg << " RoughT ....... " << (_match_methods[kRoughT] ? "enabled!" : "disabled!") << std::endl;
    msg << " SpacePoint ... " << (_match_methods[kSpacePoint] ? "enabled!" : "disabled!") << std::endl;
    msg << " SumCharge .... " << (_match_methods[kSumCharge] ? "enabled!" : "disabled!") << std::endl;
    msg << std::endl;
    msg
      << " Overlay-Time Fraction Cut : " << _overlay_tratio_cut << std::endl
      << " Charge-Ratio Diff. Cut    : " << _qratio_cut << std::endl
      << " Minimum # of SpacePoint   : " << _num_sps_cut << std::endl
      << std::endl;
    msg
      << "---------------------------------------------" << std::endl;

    mf::LogWarning("ClusterMatchAlg")<<msg.str();

  }

void cluster::ClusterMatchAlg::SetMCTruthModName ( std::string  name )

inline

Method to specify input MCTruth's module name (optional)

Definition at line 110 of file ClusterMatchAlg.h.

References _ModName_MCTruth, AppendClusterInfo(), tca::evt, FillMCInfo(), GetMatchedClusters(), MatchThreePlanes(), MatchTwoPlanes(), and lar::dump::vector().

    {_ModName_MCTruth = name;}

bool cluster::ClusterMatchAlg::StoreSpacePoints ( ) const

inline

Method to check if it is configured to store SpacePoint.

Definition at line 142 of file ClusterMatchAlg.h.

References _store_sps, AppendClusterTreeVariables(), ClearEventInfo(), ClearMatchInputInfo(), ClearMatchOutputInfo(), ClearTTreeInfo(), FillHitInfo(), Match_RoughTime(), Match_RoughZ(), Match_SpacePoint(), Match_SumCharge(), PrepareDetParams(), PrepareTTree(), and lar::dump::vector().

{ return _store_sps; }

Member Data Documentation

std::vector<double> cluster::ClusterMatchAlg::_charge_v

protected

Definition at line 276 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

TTree* cluster::ClusterMatchAlg::_cluster_tree

protected

Definition at line 274 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClusterMatchAlg(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

bool cluster::ClusterMatchAlg::_debug_mode

protected

Boolean to enable debug mode (call all enabled matching methods)

Definition at line 222 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), Match_SpacePoint(), MatchThreePlanes(), MatchTwoPlanes(), and ReportConfig().

bool cluster::ClusterMatchAlg::_det_params_prepared

protected

Definition at line 221 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), and PrepareDetParams().

bool cluster::ClusterMatchAlg::_match_methods[kMATCH_METHOD_MAX]

protected

Boolean list for enabled algorithms.

Definition at line 220 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), MatchThreePlanes(), MatchTwoPlanes(), and ReportConfig().

TTree* cluster::ClusterMatchAlg::_match_tree

protected

Definition at line 244 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

std::vector<std::vector<recob::SpacePoint> > cluster::ClusterMatchAlg::_matched_sps_v

protected

Local SpacePoint vector container.

Definition at line 215 of file ClusterMatchAlg.h.

Referenced by ClearMatchOutputInfo(), GetMatchedSpacePoints(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<unsigned int> cluster::ClusterMatchAlg::_matched_uclusters_v

protected

U plane matched clusters' index.

Definition at line 212 of file ClusterMatchAlg.h.

Referenced by ClearMatchOutputInfo(), GetMatchedClusters(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<unsigned int> cluster::ClusterMatchAlg::_matched_vclusters_v

protected

V plane matched clusters' index.

Definition at line 213 of file ClusterMatchAlg.h.

Referenced by ClearMatchOutputInfo(), GetMatchedClusters(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<unsigned int> cluster::ClusterMatchAlg::_matched_wclusters_v

protected

W plane matched clusters' index.

Definition at line 214 of file ClusterMatchAlg.h.

Referenced by ClearMatchOutputInfo(), GetMatchedClusters(), and MatchThreePlanes().

double cluster::ClusterMatchAlg::_mc_E

protected

Definition at line 246 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Px

protected

Definition at line 247 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Py

protected

Definition at line 248 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Pz

protected

Definition at line 249 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Vx

protected

Definition at line 250 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Vy

protected

Definition at line 251 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_mc_Vz

protected

Definition at line 252 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

std::string cluster::ClusterMatchAlg::_ModName_MCTruth

protected

MCTruth producer's module name.

Definition at line 229 of file ClusterMatchAlg.h.

Referenced by FillMCInfo(), and SetMCTruthModName().

std::vector<uint16_t> cluster::ClusterMatchAlg::_nhits_v

protected

Definition at line 277 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<uint16_t> cluster::ClusterMatchAlg::_nsps

protected

Definition at line 266 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_SpacePoint(), and PrepareTTree().

size_t cluster::ClusterMatchAlg::_num_sps_cut

protected

Number of SpacePoint used to cut in Match_SpacePoint method.

Definition at line 205 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), Match_SpacePoint(), and ReportConfig().

double cluster::ClusterMatchAlg::_overlay_tratio_cut

protected

Minimum overlayed time fraction among two clusters used in Match_RoughTime method.

Definition at line 206 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), Match_RoughTime(), and ReportConfig().

int cluster::ClusterMatchAlg::_pdgid

protected

Definition at line 253 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), FillMCInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_qratio_cut

protected

Maximum difference among clusters' charge sum used in Match_SumCharge method.

Definition at line 207 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), Match_SumCharge(), and ReportConfig().

std::vector<double> cluster::ClusterMatchAlg::_qratio_v

protected

Definition at line 267 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_SumCharge(), and PrepareTTree().

bool cluster::ClusterMatchAlg::_save_cluster_info

protected

Definition at line 273 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), and PrepareTTree().

trkf::SpacePointAlg* cluster::ClusterMatchAlg::_sps_algo

protected

SpacePointFinder algorithm pointer.

Definition at line 239 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), and Match_SpacePoint().

bool cluster::ClusterMatchAlg::_store_sps

protected

Boolean to enable storage of SpacePoint vector.

Definition at line 223 of file ClusterMatchAlg.h.

Referenced by ClusterMatchAlg(), MatchThreePlanes(), MatchTwoPlanes(), and StoreSpacePoints().

std::vector<double> cluster::ClusterMatchAlg::_tend_max_v

protected

Definition at line 283 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_tend_min_v

protected

Definition at line 282 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

double cluster::ClusterMatchAlg::_time_offset_uplane

protected

Definition at line 225 of file ClusterMatchAlg.h.

Referenced by FillHitInfo(), and PrepareDetParams().

double cluster::ClusterMatchAlg::_time_offset_vplane

protected

Definition at line 226 of file ClusterMatchAlg.h.

Referenced by FillHitInfo(), and PrepareDetParams().

double cluster::ClusterMatchAlg::_time_offset_wplane

protected

Definition at line 227 of file ClusterMatchAlg.h.

Referenced by FillHitInfo(), and PrepareDetParams().

unsigned short cluster::ClusterMatchAlg::_tot_pass_qsum

protected

Definition at line 257 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned short cluster::ClusterMatchAlg::_tot_pass_sps

protected

Definition at line 260 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned short cluster::ClusterMatchAlg::_tot_pass_t

protected

Definition at line 258 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned short cluster::ClusterMatchAlg::_tot_pass_z

protected

Definition at line 259 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned int cluster::ClusterMatchAlg::_tot_planes

protected

Definition at line 224 of file ClusterMatchAlg.h.

Referenced by Match_SpacePoint(), and PrepareDetParams().

unsigned short cluster::ClusterMatchAlg::_tot_u

protected

Definition at line 254 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned short cluster::ClusterMatchAlg::_tot_v

protected

Definition at line 255 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

unsigned short cluster::ClusterMatchAlg::_tot_w

protected

Definition at line 256 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), MatchThreePlanes(), MatchTwoPlanes(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_tpeak_max_v

protected

Definition at line 281 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_tpeak_min_v

protected

Definition at line 280 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_tstart_max_v

protected

Definition at line 279 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_tstart_min_v

protected

Definition at line 278 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<uint16_t> cluster::ClusterMatchAlg::_u_nhits_v

protected

Definition at line 263 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_SpacePoint(), and PrepareTTree().

std::vector<cluster_match_info> cluster::ClusterMatchAlg::_ucluster_v

protected

Local cluster data container... U-plane.

Definition at line 235 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<art::PtrVector<recob::Hit> > cluster::ClusterMatchAlg::_uhits_v

protected

Local Hit pointer vector container ... U-plane.

Definition at line 231 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<double> cluster::ClusterMatchAlg::_uv_tratio_v

protected

Definition at line 268 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_RoughTime(), and PrepareTTree().

std::vector<uint16_t> cluster::ClusterMatchAlg::_v_nhits_v

protected

Definition at line 264 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_SpacePoint(), and PrepareTTree().

std::vector<cluster_match_info> cluster::ClusterMatchAlg::_vcluster_v

protected

Local cluster data container... V-plane.

Definition at line 236 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<art::PtrVector<recob::Hit> > cluster::ClusterMatchAlg::_vhits_v

protected

Local Hit pointer vector container ... V-plane.

Definition at line 232 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<uint16_t> cluster::ClusterMatchAlg::_view_v

protected

Definition at line 275 of file ClusterMatchAlg.h.

Referenced by AppendClusterTreeVariables(), ClearTTreeInfo(), and PrepareTTree().

std::vector<double> cluster::ClusterMatchAlg::_vw_tratio_v

protected

Definition at line 269 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_RoughTime(), and PrepareTTree().

std::vector<uint16_t> cluster::ClusterMatchAlg::_w_nhits_v

protected

Definition at line 265 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_SpacePoint(), and PrepareTTree().

std::vector<cluster_match_info> cluster::ClusterMatchAlg::_wcluster_v

protected

Local cluster data container... W-plane.

Definition at line 237 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<art::PtrVector<recob::Hit> > cluster::ClusterMatchAlg::_whits_v

protected

Local Hit pointer vector container ... W-plane.

Definition at line 233 of file ClusterMatchAlg.h.

Referenced by AppendClusterInfo(), ClearMatchInputInfo(), Match_SpacePoint(), MatchThreePlanes(), and MatchTwoPlanes().

std::vector<double> cluster::ClusterMatchAlg::_wu_tratio_v

protected

Definition at line 270 of file ClusterMatchAlg.h.

Referenced by ClearTTreeInfo(), Match_RoughTime(), and PrepareTTree().

---

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

• /cvmfs/larsoft.opensciencegrid.org/products/larreco/v07_10_02/source/larreco/RecoAlg/ClusterMatchAlg.h
• /cvmfs/larsoft.opensciencegrid.org/products/larreco/v07_10_02/source/larreco/RecoAlg/ClusterMatchAlg.cxx