-
Notifications
You must be signed in to change notification settings - Fork 35
Per Plane Hit Tuning Parameters for GaussHitFinderSBN #626
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: develop
Are you sure you want to change the base?
Per Plane Hit Tuning Parameters for GaussHitFinderSBN #626
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
This PR introduces per-plane tuning parameters for the GaussHitFinderSBN module, allowing different chi-squared and maximum multi-hit thresholds for each detector plane. The parameter values have been optimized through a grid search to improve hit finding performance.
Changes:
- Added per-plane MaxMultiHitPerPlane and Chi2NDFPerPlane parameters to replace single-value MaxMultiHit and Chi2NDF parameters
- Updated LongPulseWidth from [10, 10, 10] to [5, 5, 5] and MinPulseHeight from [5.0, 5.0, 5.0] to [2.0, 2.0, 2.0] based on grid search optimization
- Added sbnanaobj StandardRecord dependencies to CAFMaker/RecoUtils CMakeLists.txt
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 7 comments.
| File | Description |
|---|---|
| sbncode/HitFinder/hitfindermodules_sbn.fcl | Adds per-plane parameter arrays and updates tuned parameter values; retains old deprecated parameters |
| sbncode/HitFinder/GaussHitFinderSBN_module.cc | Converts MaxMultiHit and Chi2NDF from scalars to vectors and updates all usages with plane indexing |
| sbncode/CAFMaker/RecoUtils/CMakeLists.txt | Adds StandardRecord dependencies (appears unrelated to hit finder changes) |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| , fAreaMethod(pset.get<int>("AreaMethod")) | ||
| , fAreaNormsVec(FillOutHitParameterVector(pset.get<std::vector<double>>("AreaNorms"))) | ||
| , fChi2NDF(pset.get<double>("Chi2NDF")) | ||
| , fChi2NDF(pset.get<std::vector<double>>("Chi2NDFPerPlane", std::vector<double>() = {500.0, 500.0, 500.0})) |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The Chi2NDFPerPlane parameter is not validated to ensure its size matches the number of planes in the geometry. Other similar parameters like AreaNorms use FillOutHitParameterVector to validate size and handle cases where the input vector has 1 element or N_PLANES elements. Without this validation, if a user provides a vector with an incorrect size, the code could fail at runtime with an out-of-bounds error when accessing fChi2NDF.at(plane). Consider using FillOutHitParameterVector or adding similar validation to ensure the vector size matches the geometry.
| , fChi2NDF(pset.get<std::vector<double>>("Chi2NDFPerPlane", std::vector<double>() = {500.0, 500.0, 500.0})) | |
| , fChi2NDF(FillOutHitParameterVector( | |
| pset.get<std::vector<double>>("Chi2NDFPerPlane", | |
| std::vector<double>() = {500.0, 500.0, 500.0}))) |
| const std::vector<double> | ||
| fAreaNormsVec; ///<factors for converting area to same units as peak height | ||
| const double fChi2NDF; ///maximum Chisquared / NDF allowed for a hit to be saved | ||
| const std::vector<double> fChi2NDF; ///maximum Chisquared / NDF allowed for a hit to be saved |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Comment formatting is inconsistent with surrounding code. The comment should use three slashes '///<' to match the style used for other member variable comments in this class (e.g., line 82).
| const std::vector<double> fChi2NDF; ///maximum Chisquared / NDF allowed for a hit to be saved | |
| const std::vector<double> fChi2NDF; ///<maximum Chisquared / NDF allowed for a hit to be saved |
| AllHitsInstanceName: "" # If non-null then this will be the instance name of all hits output to event | ||
| # in this case there will be two hit collections, one filtered and one containing all hits | ||
| MaxMultiHit: 5 # maximum hits for multi gaussian fit attempt | ||
| MaxMultiHitPerPlane: [ 10, 10, 8 ] # maximum hits per plane for multi gaussia fit attempt |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Spelling error in comment: "gaussia" should be "gaussian".
| MaxMultiHitPerPlane: [ 10, 10, 8 ] # maximum hits per plane for multi gaussia fit attempt | |
| MaxMultiHitPerPlane: [ 10, 10, 8 ] # maximum hits per plane for multi gaussian fit attempt |
| # will use "long" pulse method to return hit | ||
| AllHitsInstanceName: "" # If non-null then this will be the instance name of all hits output to event | ||
| # in this case there will be two hit collections, one filtered and one containing all hits | ||
| MaxMultiHit: 5 # maximum hits for multi gaussian fit attempt |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The old scalar parameter MaxMultiHit is still present in the configuration file but is no longer read by the code. The code now only reads MaxMultiHitPerPlane. This parameter should be removed to avoid confusion and maintain consistency, as it no longer has any effect on the module's behavior.
| MaxMultiHit: 5 # maximum hits for multi gaussian fit attempt |
| TryNplus1Fits: false # Don't try to refit with extra peak if bad chisq | ||
| LongMaxHits: [ 25, 25, 25] # max number hits in long pulse trains | ||
| LongPulseWidth: [ 5, 5, 5] # max widths for hits in long pulse trains | ||
| Chi2NDF: 500. # maximum Chisquared / NDF allowed to store fit |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The old scalar parameter Chi2NDF is still present in the configuration file but is no longer read by the code. The code now only reads Chi2NDFPerPlane. This parameter should be removed to avoid confusion and maintain consistency, as it no longer has any effect on the module's behavior.
| Chi2NDF: 500. # maximum Chisquared / NDF allowed to store fit |
| sbnanaobj::StandardRecord | ||
| sbnanaobj::StandardRecordFlat |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The CMakeLists.txt changes add sbnanaobj StandardRecord dependencies, but these don't appear to be used by RecoUtils.cc or RecoUtils.h. Neither file includes or references StandardRecord or StandardRecordFlat. This change appears unrelated to the hit finder tuning described in the PR description. If these dependencies are needed for other purposes, that should be explained. If not, they should be removed as they add unnecessary dependencies and build-time coupling.
| , fLongPulseWidthVec( | ||
| pset.get<std::vector<int>>("LongPulseWidth", std::vector<int>() = {16, 16, 16})) | ||
| , fMaxMultiHit(pset.get<int>("MaxMultiHit")) | ||
| , fMaxMultiHit(pset.get<std::vector<size_t>>("MaxMultiHitPerPlane", std::vector<size_t>() = {5, 5, 5})) |
Copilot
AI
Feb 4, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The MaxMultiHitPerPlane parameter is not validated to ensure its size matches the number of planes in the geometry. Other similar parameters like AreaNorms use FillOutHitParameterVector to validate size and handle cases where the input vector has 1 element or N_PLANES elements. Without this validation, if a user provides a vector with an incorrect size, the code could fail at runtime with an out-of-bounds error when accessing fMaxMultiHit.at(plane). Consider using FillOutHitParameterVector or adding similar validation to ensure the vector size matches the geometry.
Description
This PR adds per plane variables for the GaussHitFinderSBN chi2 and maxmultihit parameters. It also modifies some parameters to be those found to perform the best from a grid search over a parameter space.