Add SpectrumFileProcessor class for automated spectral data conversion and formatting

[krishnatejavedula]

• Implemented SpectrumFileProcessor class to handle energy and flux data conversion for spectrum files not in the MEGAlib spectrum file format.
• Added energy conversion feature: converts frequency (Hz) to energy (keV) and flux from ergs/cm²/sec to ph/cm²/sec/keV using astropy units.
• Implemented data filtering to restrict energy range to 100 keV - 10,000 keV for accurate source injector functionality.
• Reformatted output to ensure compatibility with SpecFromDat class and consistency across cosipy and DCs spectral files.

[codecov]

Codecov Report

❌ Patch coverage is 0% with 75 lines in your changes missing coverage. Please review.
✅ Project coverage is 77.19%. Comparing base (e3d4d83) to head (4449ffd).

Files with missing lines	Patch %	Lines
cosipy/data_io/custom_functions.py	0.00%	75 Missing ⚠️

❌ Your patch check has failed because the patch coverage (0.00%) is below the target coverage (100.00%). You can increase the patch coverage or adjust the target coverage.

Files with missing lines	Coverage Δ
cosipy/data_io/custom_functions.py	0.00% <0.00%> (ø)

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

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

[hiyoneda]

@krishnatejavedula Thanks for this work. Looks good. I have a quick comment. threeml/custom_function.py, to which you added this new class, is used to implement new spectral and spatial functions for astromodels in threeml fitting. I think that your new class can be used more generally. Can you think of a better directory for this class, maybe dataIO?

[israelmcmc]

Thanks @krishnatejavedula. Any updates to this?

• I think what @hiyoneda suggested makes sense. Since there don't seem to be any interactions of SpectrumFileProcessor with 3ML, you can move this class to its own file inside the DataIO module.
• Besides that, the other thing to resolve is to add unit tests to cover this new class.

[Yong2Sheng]

I tested the module and it works well.

[israelmcmc]

@krishnatejavedula What's the status of this PR? are the unit tests the only thing missing?

[krishnatejavedula]

@israelmcmc It believe the code needs some refactoring and must be checked to see if it conflicts with any new changes to the source injector.

[israelmcmc]

Got it, thanks for the update @krishnatejavedula!

[read-the-docs-community]

Documentation build overview

📚 cositools-cosipy | 🛠️ Build #33315512 | 📁 Comparing 99789c4 against latest (4dd844d)

  🔍 Preview build  

14 files changed · ± 9 modified · - 5 deleted

± Modified

• genindex.html
• api/index.html
• api/polarization.html
• api/threeml.html
• tutorials/DataIO/DataIO_example.html
• tutorials/polarization/ASAD_method.html
• tutorials/polarization/Stokes_method.html
• tutorials/polarization/maximum_likelihood_method.html
• tutorials/source_injector/Point_source_injector.html

- Deleted

• py-modindex.html
• _modules/index.html
• _modules/cosipy/polarization/conventions.html
• _modules/cosipy/polarization/polarization_angle.html
• _modules/cosipy/polarization/polarization_axis.html