Feature to normalize for YZ non-uniformity

[sxy1439]

Description

Please provide a detailed description of the changes this pull request introduces.

This PR is to normalize the charge response for the non-uniformity along the YZ plane. This feature takes the input YZ map and normalizes the dQ/dx of each hit using the correction factor from the corresponding YZ bin where the hit is located. Some printed value of dqdx before and after normalization:

[NormalizeYZ] Plane: 1, TPC: 0, Y: -196.216, Z: 169.939, Scale: 0.957026, dQdx (raw): 1319.81, dQdx (corrected): 1379.07
[NormalizeYZ] Plane: 2, TPC: 1, Y: 169.547, Z: 286.94, Scale: 1.01907, dQdx (raw): 1108.2, dQdx (corrected): 1087.47

This pull and push the dQ/dx depending on whether we are in the high or low charge response region to normalize the charge response throughout the plane.

Attached is also the YZ map from collection plane along the east and west TPCs in the bins of 1x1cm2.


Note that this map has been produced with officially processed data sample (1e20 data sample data_MCP2025B_02_DevSample_1e20_bnblight_v10_06_00_02_histreco2_sbnd), which still have non-uniformity due to coherent noise removal issue #772

Additionally, below is the dQ/dx distribution with (red) and without (blue) normalization, which shows narrowing around the peak region after normalization.

$${\color{red}!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!}$$

$${\color{red}\bf{\textrm{IMPORTANT UPDATE June 22nd 2025:}}}$$ If you are making a PR which is intended as a patch for the CURRENT production (which started in Spring 2025), you must make two PRs: one for develop and one for the production/v10_06_00 branch.

$${\color{red}!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!}$$

Checklist

• Added at least 1 label from available labels.
• Assigned at least 1 reviewer under Reviewers,
• Assigned all contributers including yourself under Assignees
• Linked any relevant issues under Developement
• Does this PR affect CAF data format? If so, please assign a CAF maintainer (PetrilloAtWork or JosiePaton) as additional reviewer. No
• Does this affect the standard workflow? No
• Is this PR a patch for the ongoing production? If so, separate PR must also be made for production/v10_06_00 branch! will do!

Relevant PR links (optional)

Does this PR require merging another PR in a different repository (such as sbnanobj/sbnobj etc.)?

Link(s) to docdb describing changes (optional)

Is there a docdb describing the issue this solves or the feature added?

[linyan-w]

This is a patch that goes into the current (spring) production. @sxy1439 could you please make another PR for the production/v10_06_00 branch?

[nathanielerowe]

@mrmooney @sxy1439 Hello, just a reminder that you will need to review/resolve issues with this PR before I can merge it. Let me know when the corresponding sbnd_data edit is ready and send me the path!

[sxy1439]

@nathanielerowe I have the corresponding sbnd_data directory with the YZ maps located at:
/exp/sbnd/app/users/yadav/Calibration/sbndcode_v10_06_01/sbnd_data/
I’ve also created a separate PR for the production/v10_06_00 branch, and since the required files are the same, I believe this same path can be used there as well.

[linyan-w]

This PR is ready to merge into develop.
An identical PR #777 patches the spring production.

[nathanielerowe]

trigger build ci_ref=v10_06_02 LArSoft/lar*@LARSOFT_SUITE_v10_06_00 SBNSoftware/sbncode@v10_06_00_04 SBNSoftware/sbnanaobj@v10_00_05 SBNSoftware/sbnobj@v10_01_01 SBNSoftware/sbnalg@v10_06_00_03

[FNALbuild]

✔️ CI build for LArSoft Succeeded on slf7 for c14:prof -- details available through the CI dashboard

[FNALbuild]

✔️ CI build for LArSoft Succeeded on slf7 for e26:prof -- details available through the CI dashboard

[FNALbuild]

❌ CI build for SBND Failed at phase build SBND on slf7 for c14:prof -- details available through the CI dashboard

🚨 For more details about the failed phase, check the build SBND phase logs

parent CI build details are available through the CI dashboard

[FNALbuild]

⚠️ CI build for SBND Warning at phase ci_tests SBND on slf7 for e26:prof - ignored warnings for build -- details available through the CI dashboard

🚨 For more details about the warning phase, check the ci_tests SBND phase logs

parent CI build details are available through the CI dashboard

[nathanielerowe]

Approved!