Fiducial Volume Class in WCT

[lastgeorge]

Fiducial Volume Management System Design for the New Toolkit

Explaination of ToyFiducial Fiducial Volume system: https://github.com/BNLIF/wire-cell-2dtoy/blob/porting/docs/ToyFiducial_1.md

Explaination of ToyFiducial Event Tagging system: https://github.com/BNLIF/wire-cell-2dtoy/blob/porting/docs/ToyFiducial_2.md

Overview

This system manages the fiducial volume and provides essential transformations and utilities for efficient event reconstruction and analysis. It supports wire-based readout systems and accounts for dead regions while offering flexibility for future extensions.

---

Components

1. Boundary Definition Variables

• Define the limits of the fiducial volume in 3D space.
• Example: (xmin, xmax), (ymin, ymax), (zmin, zmax) for Cartesian boundaries.

2. Coordinate Transformation: Wire-Channel to 3D Space Points

• Converts wire-based readout (wire, channel) information into corresponding 3D spatial coordinates.
• Uses predefined geometry mappings between wire planes and the detector volume.
• May involve:
  • Plane-specific offsets and rotations
  • Mapping function: (wire, channel) <-> (x, y, z)

3. Dead Region (Channel) Management System

• Identifies and manages channels that are non-operational or problematic.
• Stores dead channels/regions in a look-up table or mask.
• Ensures these regions are excluded from reconstruction algorithms.

4. Transformation System: Reconstructed Position to True Position

• Provides transformations between reconstructed positions and true physical positions.
• Requires knowledge of T0 timing for each cluster to account for drift corrections.
• Example correction model:
  • true_position <-> reconstructed_position given T0

---

Basic Utility Functions

1. Check if a Point is Within the Fiducial Volume

2. Check if a Point is Within a Dead Region

3. Adjust Cluster Point Location with T0 Timing and Correction Function