UVBeam overhaul

[bhazelton]

UVBeam overhaul

Completely overhaul the handling of UVBeam beams.

Note that using this requires having the fhd_beam_decompose branch on pyuvdata installed.

Note that this currently branches off of #71, so it contains those fixes as well.

fixes #64

Types of Changes

• Bug Fixes
• New Feature(s)
• Breaking Changes
• Documentation
• Version Change
• Translation from FHD
• Build or CI Change

Changelog

Breaking Changes!

• If any code you have produced breaks backwards compatibility with previous versions and will break existing codebases put those changes here

New Features

• Add any new features here and if they were from an issue, ideally keep the issue open and have it get resolved through the pull request being merged and closed using the closing keywords followed by the issue number Linking a pull request to an issue using a keyword.

Bug Fixes

• Any any bug fixes here and if they were from an issue, ideally keep the issue open and have it get resolved through the pull request being merged and closed using the closing keywords followed by the issue number Linking a pull request to an issue using a keyword.

Test Changes

• Any new tests added mention them here
• Any changes to existing tests and the reasons for why they have been changed also noted.

Dependency Changes

• Any new dependencies, add them here

Version Changes

• Note what version you're getting ready for and the changelog changes, try to go through previous pull requests after the current release and try to add things to the changelog if they have been missed.

Build/CI changes

• Note any new CI setups, changes of the build going to PyPI and Conda-Forge

Translation Changes

• If you translated anything from the original FHD, please explain why

Checklist

General PR Checklist

• I have the read the contribution guide
• Add all the above to the Changelog into the unreleased section

New Features Checklist

• New Features have all new functions documented using the numpydoc docstring format
• Updated an existing tutorial or created a tutorial to use the new feature in the documentation
• Have added new tests or changed existing tests to cover the new feature

Existing Tests Checklist

• If some tests fail and they are meant to, have they been changed? if so mention the exact tests that were changed and why here
• Have the changes to existing tests been documented either through comments, changes to the docstring in ether the test or the associated functions?

Breaking Changes Checklist

• The breaking changes have been noted in the change log
• The breaking changes have been noted as a warning in any relevant tutorials in the documentation
• The breaking changes have been noted as a warning in any relevant functions in the API documentation, this should be put under the Warnings section in the numpydoc for the associated functions, please note the version that the breaking change is not in. For example if the current version is 1.1 and you make the breaking change for it to be in version 1.2, say there has been a breaking change for versions <=1.1 and indicate what the change is.

Bug Fixes Checklist

• Added all bug fixes with any issues associated with them linked.
• Added new tests to cover bugs
• Adjusted existing tests to cover bug, in which case check the Existing Tests Checklist

Documentation Checklist

• The documentation is able to build successfully with any new changes and they are visible in your own build

Version Checklist

• Updated the changelog to put all the previous unreleased changelog into a version
• Noted dependency changes since the last version

Build/CI

• Added a badge for any new CI actions or setups
• Existing badges remain unaffected, if not, document why in changelog

Translation Checklist

• I have read the Translation Contribution guide
• I have created new tests and added them to the FHD Test source for any other developers to also test
• I have followed all previous checklists as additional Translation of FHD usually includes all of the above

[codecov]

Codecov Report

❌ Patch coverage is 7.61905% with 97 lines in your changes missing coverage. Please review.
✅ Project coverage is 33.10%. Comparing base (a0cea8d) to head (7336c61).

Files with missing lines	Patch %	Lines
PyFHD/beam_setup/antenna.py	0.00%	29 Missing ⚠️
PyFHD/pyfhd.py	0.00%	18 Missing ⚠️
PyFHD/beam_setup/beam.py	0.00%	14 Missing ⚠️
PyFHD/beam_setup/beam_utils.py	0.00%	14 Missing ⚠️
PyFHD/data_setup/uvfits.py	36.36%	4 Missing and 3 partials ⚠️
PyFHD/source_modeling/vis_model_transfer.py	0.00%	7 Missing ⚠️
PyFHD/pyfhd_tools/pyfhd_setup.py	44.44%	2 Missing and 3 partials ⚠️
PyFHD/calibration/calibration_utils.py	0.00%	2 Missing ⚠️
PyFHD/plotting/image.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #72      +/-   ##
==========================================
+ Coverage   32.86%   33.10%   +0.24%     
==========================================
  Files          27       26       -1     
  Lines        5501     5476      -25     
  Branches     1002     1002              
==========================================
+ Hits         1808     1813       +5     
+ Misses       3496     3463      -33     
- Partials      197      200       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

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