Belle II Software  release-08-01-10
Public Member Functions | Static Public Attributes | List of all members
PXDClusterShape Class Reference

Class to correct estimation of cluster error and position base on its shape. More...

#include <PXDClusterShape.h>

Collaboration diagram for PXDClusterShape:
Collaboration graph
[legend]

Public Member Functions

 ~PXDClusterShape ()
 Delete the cache and free the memory.
 
pxdClusterShapeType setClsShape (const ClusterCandidate &cls, VxdID sensorID)
 Set cluster shape ID. More...
 

Static Public Attributes

static pxdClusterShapeDescr pxdClusterShapeDescription
 Create detail description of cluster shape. More...
 

Detailed Description

Class to correct estimation of cluster error and position base on its shape.

This class will set a shape ID of cluster in clusterization time. ID is describe on list "pxdClusterShapeType". Function "pxdClusterShapeDescription" give more detail desription of shape.

Function "setClsShape" set shape ID for cluster. Correction is apply for RecoHit if available direction of reco track

*   u → → → → → → → → → →
* v┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐v
* ↑│-│-│-│-│-│-│-│-│-│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑
* ↑│-│-│-│x│-│-│-│-│-│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"L"
* ↑│-│-│-│x│x│-│-│-│x│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"mirror_u_L"
* ↑│-│-│-│-│-│-│-│x│x│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑
* ↑│-│-│-│x│x│-│-│-│-│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"mirror_v_L"
* ↑│-│-│-│x│-│-│-│x│x│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"mirror_u+v_L"
* ↑│-│-│-│-│-│-│-│-│x│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑
* ↑│-│-│-│-│x│-│-│-│-│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"2x2 diagonal"
* ↑│-│-│-│x│-│-│-│x│-│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑"2x2 anti-diagonal"
* ↑│-│-│-│-│-│-│-│-│x│-│-│↑
* ↑├─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┤↑
* ↑│-│-│-│-│-│-│-│-│-│-│-│↑
* v└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘v
* - u → → → → → → → → → →
*

Definition at line 82 of file PXDClusterShape.h.

Member Function Documentation

◆ setClsShape()

pxdClusterShapeType setClsShape ( const ClusterCandidate &  cls,
VxdID  sensorID 
)

Set cluster shape ID.

Set cluster shape ID

Parameters
clsClusterCandidate container of pixels creating cluster in PXD
sensorIDsensor details for PXD sensors
Returns
cluster shape ID

Definition at line 51 of file PXDClusterShape.cc.

52  {
53  const SensorInfo& info = dynamic_cast<const SensorInfo&>(VXD::GeoCache::get(
54  sensorID));
55  pxdClusterShapeType clsShape;
56  clsShape = pxdClusterShapeType::no_shape_set;
57  ClusterProjection projU, projV;
58  float fCategU = 0.0;
59  float fCategV = 0.0;
60  float fDiagU = 0.0;
61  float fDiagV = 0.0;
62  int CSFull = 0;
63  for (const PXD::Pixel& px : cls.pixels()) {
64  if (CSFull == 0) {
65  fDiagU = px.getU();
66  fDiagV = px.getV();
67  }
68  if (CSFull < 3) {
69  fCategU += px.getU();
70  fCategV += px.getV();
71  }
72  CSFull++;
73  projU.add(px.getU(), info.getUCellPosition(px.getU()), px.getCharge());
74  projV.add(px.getV(), info.getVCellPosition(px.getV()), px.getCharge());
75 
76 
77  }
78  projU.finalize();
79  projV.finalize();
80 
81  if (CSFull == 1) {
82  clsShape = pxdClusterShapeType::shape_1; // 1x1 pixels
83  } else if (CSFull == 2) {
84  if ((projU.getSize() == 2) && (projV.getSize() == 1)) {
85  clsShape = pxdClusterShapeType::shape_2_u; // 2x1 (u,v) pixels
86  } else if ((projU.getSize() == 1) && (projV.getSize() == 2)) {
87  clsShape = pxdClusterShapeType::shape_2_v; // 1x2 (u,v) pixels
88  } else if ((fDiagU < (fCategU / 2.0)) && (fDiagV < (fCategV / 2.0))) {
89  clsShape = pxdClusterShapeType::shape_2_uv_diag; // 2x2 diagonal (u,v) pixels
90  } else {
91  clsShape = pxdClusterShapeType::shape_2_uv_antidiag; // 2x2 anti-diagonal (u,v) pixels
92  }
93  } else if (CSFull == 3) {
94  if ((projU.getSize() == 2) && (projV.getSize() == 2)) {
95  int MisU = 0; // missing pixel in "L" cluster - u marker
96  int MisV = 0; // missing pixel in "L" cluster - v marker
97  fCategU /= 3.0;
98  fCategV /= 3.0;
99  if ((fCategU - (int)fCategU) < 0.5) {
100  MisU = 1;
101  }
102  if ((fCategV - (int)fCategV) < 0.5) {
103  MisV = 1;
104  }
105  if ((MisU == 1) && (MisV == 1)) {
106  clsShape = pxdClusterShapeType::shape_3_L; // 2x2 (u,v) three pixels: o* (L)
107  // oo
108  } else if ((MisU == 0) && (MisV == 1)) {
109  clsShape = pxdClusterShapeType::shape_3_L_mirr_u; // 2x2 (u,v) three pixels: *o (mirror_u_L)
110  // oo
111  } else if ((MisU == 1) && (MisV == 0)) {
112  clsShape = pxdClusterShapeType::shape_3_L_mirr_v; // 2x2 (u,v) three pixels: oo (mirror_v_L)
113  // o*
114  } else if ((MisU == 0) && (MisV == 0)) {
115  clsShape = pxdClusterShapeType::shape_3_L_mirr_uv; // 2x2 (u,v) three pixels: oo (mirror_u+v_L)
116  // *o
117  }
118  } else if (projV.getSize() == 1) {
119  clsShape = pxdClusterShapeType::shape_N1; // Nx1 (u,v) pixels, N > 2
120  } else if (projU.getSize() == 1) {
121  clsShape = pxdClusterShapeType::shape_1M; // 1xM (u,v) pixels, M > 2
122  } else if (projV.getSize() == 2) {
123  clsShape = pxdClusterShapeType::shape_N2; // Nx2 (u,v) pixels, N > 2
124  } else if (projU.getSize() == 2) {
125  clsShape = pxdClusterShapeType::shape_2M; // 2xM (u,v) pixels, M > 2
126  } else {
127  clsShape = pxdClusterShapeType::shape_large; // big cluster over 2x2 pixels
128  }
129  } else if (CSFull == 4) {
130  if ((projU.getSize() == 2) && (projV.getSize() == 2)) {
131  clsShape = pxdClusterShapeType::shape_4; // 2x2 (u,v) four pixels
132  } else if (projV.getSize() == 1) {
133  clsShape = pxdClusterShapeType::shape_N1; // Nx1 (u,v) pixels, N > 2
134  } else if (projU.getSize() == 1) {
135  clsShape = pxdClusterShapeType::shape_1M; // 1xM (u,v) pixels, M > 2
136  } else if (projV.getSize() == 2) {
137  clsShape = pxdClusterShapeType::shape_N2; // Nx2 (u,v) pixels, N > 2
138  } else if (projU.getSize() == 2) {
139  clsShape = pxdClusterShapeType::shape_2M; // 2xM (u,v) pixels, M > 2
140  } else {
141  clsShape = pxdClusterShapeType::shape_large; // big cluster over 2x2 pixels
142  }
143  } else if (CSFull >= 5) {
144  if (projV.getSize() == 1) {
145  clsShape = pxdClusterShapeType::shape_N1; // Nx1 (u,v) pixels, N > 2
146  } else if (projU.getSize() == 1) {
147  clsShape = pxdClusterShapeType::shape_1M; // 1xM (u,v) pixels, M > 2
148  } else if (projV.getSize() == 2) {
149  clsShape = pxdClusterShapeType::shape_N2; // Nx2 (u,v) pixels, N > 2
150  } else if (projU.getSize() == 2) {
151  clsShape = pxdClusterShapeType::shape_2M; // 2xM (u,v) pixels, M > 2
152  } else {
153  clsShape = pxdClusterShapeType::shape_large; // big cluster over 2x2 pixels
154  }
155  }
156 
157  return clsShape;
158  } //setClsShape
Belle2::VXD::GeoCache::get
static const SensorInfoBase & get(Belle2::VxdID id)
Return a reference to the SensorInfo of a given SensorID.
Definition: GeoCache.h:139
Belle2::PXD::pxdClusterShapeType
pxdClusterShapeType
Type specifies cluster shape type.
Definition: PXDClusterShape.h:21

Member Data Documentation

◆ pxdClusterShapeDescription

pxdClusterShapeDescr pxdClusterShapeDescription
static
Initial value:
= {
{pxdClusterShapeType::no_shape_set, "pxd cluster shape: no shape setting"},
{pxdClusterShapeType::shape_1, "pxd cluster shape: cluster 1x1 (single) pixel"},
{pxdClusterShapeType::shape_2_u, "pxd cluster shape: cluster 2x1 (u,v) pixels"},
{pxdClusterShapeType::shape_2_v, "pxd cluster shape: cluster 1x2 (u,v) pixels"},
{pxdClusterShapeType::shape_2_uv_diag, "pxd cluster shape: cluster 2x2 diagonal (u,v) pixels"},
{pxdClusterShapeType::shape_2_uv_antidiag, "pxd cluster shape: cluster 2x2 anti-diagonal (u,v) pixels"},
{pxdClusterShapeType::shape_N1, "pxd cluster shape: cluster Nx1 (u,v) pixels, N > 2"},
{pxdClusterShapeType::shape_1M, "pxd cluster shape: cluster 1xM (u,v) pixels, M > 2"},
{pxdClusterShapeType::shape_N2, "pxd cluster shape: cluster Nx2 (u,v) pixels, N > 2"},
{pxdClusterShapeType::shape_2M, "pxd cluster shape: cluster 2xM (u,v) pixels, M > 2"},
{pxdClusterShapeType::shape_4, "pxd cluster shape: cluster 2x2 (u,v) four pixels"},
{pxdClusterShapeType::shape_3_L, "pxd cluster shape: cluster 2x2 (u,v) three pixels: (L)"},
{pxdClusterShapeType::shape_3_L_mirr_u, "pxd cluster shape: cluster 2x2 (u,v) three pixels: (mirror_u_L)"},
{pxdClusterShapeType::shape_3_L_mirr_v, "pxd cluster shape: cluster 2x2 (u,v) three pixels: (mirror_v_L)"},
{pxdClusterShapeType::shape_3_L_mirr_uv, "pxd cluster shape: cluster 2x2 (u,v) three pixels: (mirror_u+v_L)"},
{pxdClusterShapeType::shape_large, "pxd cluster shape: larger cluster over 2 pixels in u and v"}
}

Create detail description of cluster shape.

Definition at line 89 of file PXDClusterShape.h.

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