Package org.jlab.rec.dc.cluster

Class ClusterFinder

java.lang.Object

org.jlab.rec.dc.cluster.ClusterFinder

public class ClusterFinder
extends Object

A hit pruning algorithm to reject noise that gives a pattern of hits that are continguous in the same layer The algorithm first puts the hits in arrays according to their layer and wire number. Each such array contains all the hits in the same layer. The algorithm then collects groups of contiguous hits into a list of hits. The n-first and n-last hits in the list are kept, and all other hits inbetween pruned. The value of n depends on the size of the list. A loose clustering algorithm loops over all superlayers, in a sector and finds groups of hits with contiguous wire index numbers. These clusters (called clumps of hits) are delimited by layers with no hits at a particular wire coordinate. These clusters are then refined using fits to their respective wire indexes as a function of layer number to identify parallel tracks or overlapping track candidates.

Constructor Summary

Constructors

Constructor	Description
ClusterFinder()

Method Summary

Modifier and Type	Method	Description
void	fillHitArray(List<Hit> hits, int rejectLayer)	Fills 3-dimentional array of hits from input hits
List<Cluster>	findClumps(List<Hit> allhits, ClusterCleanerUtilities ct)
List<FittedCluster>	FindHitBasedClusters(List<Hit> allhits, ClusterCleanerUtilities ct, ClusterFitter cf, DCGeant4Factory DcDetector, int numTDCBankRows)
List<FittedCluster>	FindTimeBasedClusters(DataEvent event, List<FittedHit> fhits, ClusterFitter cf, ClusterCleanerUtilities ct, IndexedTable tab, DCGeant4Factory DcDetector, TimeToDistanceEstimator tde)
Hit[][][]	getHitArray()
EvioDataBank	getLayerEfficiencies(List<FittedCluster> fclusters, List<Hit> allhits, ClusterCleanerUtilities ct, ClusterFitter cf, EvioDataEvent event)
boolean	passHitSelection(Hit hit)
List<FittedCluster>	RecomposeClusters(Map<Integer,ArrayList<FittedHit>> grpHits, DCGeant4Factory dcDetector, ClusterFitter cf)
void	setHitArray(Hit[][][] hitArray)	Sets the hit array Array[total_nb_sectors*total_nb_superlayers][total_nb_wires][total_nb_layers]

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ClusterFinder

public ClusterFinder()

Method Details

getHitArray

public Hit[][][] getHitArray()

Returns:

gets 3-dimentional array of hits as Array[total_nb_sectors*total_nb_superlayers][total_nb_wires][total_nb_layers]

setHitArray

public void setHitArray(Hit[][][] hitArray)

Sets the hit array Array[total_nb_sectors*total_nb_superlayers][total_nb_wires][total_nb_layers]

Parameters:

hitArray -

fillHitArray

public void fillHitArray(List<Hit> hits,
 int rejectLayer)

Fills 3-dimentional array of hits from input hits

Parameters:

hits - the unfitted hit

rejectLayer -

findClumps

public List<Cluster> findClumps(List<Hit> allhits,
 ClusterCleanerUtilities ct)

Parameters:

allhits - the list of unfitted hits

ct -

Returns:

List of clusters

FindHitBasedClusters

public List<FittedCluster> FindHitBasedClusters(List<Hit> allhits,
 ClusterCleanerUtilities ct,
 ClusterFitter cf,
 DCGeant4Factory DcDetector,
 int numTDCBankRows)

Parameters:

allhits - the list of unfitted hits

ct -

cf -

DcDetector -

numTDCBankRows -

Returns:

clusters of hits. Hit-based tracking linear fits to the wires are done to determine the clusters. The result is a fitted cluster

RecomposeClusters

public List<FittedCluster> RecomposeClusters(Map<Integer,ArrayList<FittedHit>> grpHits,
 DCGeant4Factory dcDetector,
 ClusterFitter cf)

FindTimeBasedClusters

public List<FittedCluster> FindTimeBasedClusters(DataEvent event,
 List<FittedHit> fhits,
 ClusterFitter cf,
 ClusterCleanerUtilities ct,
 IndexedTable tab,
 DCGeant4Factory DcDetector,
 TimeToDistanceEstimator tde)

passHitSelection

public boolean passHitSelection(Hit hit)

Parameters:

hit - the hit

Returns:

a selection cut to pass the hit (for now pass all hits)

getLayerEfficiencies

public EvioDataBank getLayerEfficiencies(List<FittedCluster> fclusters,
 List<Hit> allhits,
 ClusterCleanerUtilities ct,
 ClusterFitter cf,
 EvioDataEvent event)