Add ARMSelector event selection class

[Mustafa-hub-maker]

This PR adds a first ARMSelector implementation for COSIpy event selection.

The selector applies an ARM cut using:

ARM = angular separation(source direction, event axis) - Phi

Updated implementation uses:

• Chi galactic
• Psi galactic
• Phi
• all stored in radians

Validated locally on GRB_bn110605183:

• ARM cut: ±13 deg
• GRB total events: 2,776
• GRB selected events: 554
• GRB selected fraction: 0.1996
• ARM distribution is centered close to 0°, as expected

Tests were updated accordingly:

• ARMSelector tests: 5/5 passed locally
• Related event-selection tests: 10/10 passed locally

Note:
This is the validated FITS-column implementation. A remaining refinement is adapting it to the full ComptonDataSpaceInSCFrameEventInterface, where SpacecraftHistory is used internally for the sky-to-spacecraft transformation.

[read-the-docs-community]

Documentation build overview

📚 cositools-cosipy | 🛠️ Build #32952285 | 📁 Comparing 296d8e6 against latest (4bed87c)

  🔍 Preview build  

17 files changed · ± 17 modified

± Modified

• index.html
• tutorials/index.html
• tutorials/other_examples.html
• tutorials/DataIO/DataIO_example.html
• tutorials/image_deconvolution/511keV-Galactic-ImageDeconvolution.html
• tutorials/light_curves/speclc_grbdc3.html
• tutorials/polarization/ASAD_method.html
• tutorials/source_injector/Extended_source_injector.html
• tutorials/background_estimation/continuum_estimation/BG_estimationNN_example.html
• tutorials/background_estimation/line_background/line_background_estimation_example_notebook.html
• and 7 more...

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.02%. Comparing base (a34afcd) to head (296d8e6).
⚠️ Report is 191 commits behind head on develop.

Files with missing lines	Coverage Δ
cosipy/event_selection/__init__.py	100.00% <100.00%> (ø)
cosipy/event_selection/arm_selection.py	100.00% <100.00%> (ø)

... and 47 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[israelmcmc]

Thanks for working on this @Mustafa-hub-maker.

It's on the right path, but the ARMSelector is not yet working as an EvenSelectionInterface implementation. For that to work, _select needs to accept an EvenDataInterface object, and use it for the calculation. Right now, it's taking a "table-like" object, which doesn't conform with the EvenDataInterface protocol definition. Also, the __init__ method shouldn't take the chi/psi/phi-col parameters, those are also obtained through the input EvenDataInterface object in _select. You can use existing TimeSelector class as a model for what to do.

On a separate note, it would be good if you use the existing RelativeCDSCoordinates class to compute the ARM. If you feel that your code improves upon what's already available, feel free to modify RelativeCDSCoordinates. I just want to avoid duplicated code if possible.