Dev

[ConnorStoneAstro]

No description provided.

[Copilot]

Pull request overview

This PR updates PSF-model normalization behavior and documentation, adjusts several model parameter descriptions/initialization details, and introduces a new batched Levenberg–Marquardt optimizer (BatchLM) to fit batched targets efficiently.

Changes:

• Add BatchLM optimizer plus supporting batched LM step function (batch_lm_step) and export them via astrophot.fit.
• Refactor PSF sampling/normalization to be call-time controlled (normalize_psf argument) and update PSF-related docs/tests accordingly (including Airy PSF parameter rename to R1).
• Improve/expand documentation across multiple mixins/tutorial notebooks and remove some stale Torch-specific decorations/imports.

Reviewed changes

Copilot reviewed 33 out of 33 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/test_psfmodel.py	Adjusts PSF model test skips/initialization and aligns PixelatedPSF parameter assignment with new PSF call behavior.
tests/test_model.py	Narrows model skip conditions to keep Gaussian variants exercised in tests.
docs/source/tutorials/ModelZoo.ipynb	Updates Airy PSF example parameter from aRL to R1.
docs/source/tutorials/ImageTypes.ipynb	Adds a new tutorial section demonstrating batched images and BatchLM.
docs/source/tutorials/GettingStarted.ipynb	Adds example printing of parameter descriptions.
docs/source/tutorials/AdvancedPSFModels.ipynb	Removes normalize_psf options from PSF model examples to match new PSF normalization API.
astrophot/models/sky_model_object.py	Switches __all__ definition style to a tuple.
astrophot/models/psf_model_object.py	Removes instance-level normalize_psf option and adds normalize_psf argument to __call__.
astrophot/models/point_source.py	Cleans up imports/decorators and updates docstring formatting.
astrophot/models/planesky.py	Cleans up imports/decorators, updates __all__, and refines docs/param descriptions.
astrophot/models/pixelated_psf.py	Cleans up imports/decorators and corrects parameter docs/description.
astrophot/models/pixelated_model.py	Cleans up imports/decorators and corrects parameter docs/description.
astrophot/models/multi_gaussian_expansion.py	Updates PA documentation/description wording.
astrophot/models/mixins/transform.py	Updates documentation text and modifies Fourier/Warp/Truncation initialization behavior.
astrophot/models/mixins/spline.py	Updates “Tensor” wording to “Array” in docs/descriptions.
astrophot/models/mixins/sersic.py	Refines parameter docs/descriptions for effective radius/intensity.
astrophot/models/mixins/sample.py	Replaces terse param list with a detailed explanation of sampling/integration modes.
astrophot/models/mixins/gaussian.py	Corrects Gaussian normalization in docs and clarifies flux meaning.
astrophot/models/mixins/exponential.py	Refines parameter docs/descriptions for effective radius/intensity.
astrophot/models/group_psf_model.py	Implements call-time PSF normalization propagation for PSF groups and improves docstring.
astrophot/models/gaussian_ellipsoid.py	Removes Torch no-grad decoration and cleans imports.
astrophot/models/func/gaussian.py	Changes Gaussian normalization to 2D total-flux form and updates argument docs.
astrophot/models/flatsky.py	Updates parameter docs/description wording for I0.
astrophot/models/bilinear_sky.py	Enhances documentation, tweaks initialization variables, and changes PA/scale dynamics defaults.
astrophot/models/batch_model_object.py	Improves BatchModel docs and fixes WCS source used when sampling batched scenes.
astrophot/models/basis_psf.py	Improves docstring and changes default basis-weight initialization.
astrophot/models/airy.py	Renames Airy parameter to R1, updates units/docs, and revises radial model scaling.
astrophot/fit/lm.py	Cleans imports, improves likelihood error message, and removes Torch no-grad decorations.
astrophot/fit/func/lm.py	Generalizes LM helper ops for batching, factors out rho, and adds batch_lm_step.
astrophot/fit/func/init.py	Exports batch_lm_step.
astrophot/fit/batch_lm.py	Adds new BatchLM optimizer implementation for batched fitting.
astrophot/fit/init.py	Exposes BatchLM at astrophot.fit.
.github/workflows/coverage.yaml	Bumps Codecov GitHub Action from v5 to v6.

Comments suppressed due to low confidence (1)

astrophot/models/func/gaussian.py:7

• This function now uses the 2D Gaussian normalization flux / (2πσ²), meaning flux is total integrated flux of the 2D profile. The docstring still says “Gaussian 1d profile function”, which is now misleading—please update it to reflect the 2D radial surface-brightness profile (and clarify units/interpretation of flux).

def gaussian(R: ArrayLike, sigma: ArrayLike, flux: ArrayLike) -> ArrayLike:
    """Gaussian 1d profile function, specifically designed for pytorch
    operations.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 82.05128% with 35 lines in your changes missing coverage. Please review.
✅ Project coverage is 91.23%. Comparing base (07ecdaf) to head (5691ab1).
⚠️ Report is 6 commits behind head on main.

Files with missing lines	Patch %	Lines
astrophot/fit/batch_lm.py	76.52%	27 Missing ⚠️
astrophot/fit/func/lm.py	84.78%	7 Missing ⚠️
astrophot/models/mixins/transform.py	66.66%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #299      +/-   ##
==========================================
- Coverage   91.28%   91.23%   -0.05%     
==========================================
  Files         112      113       +1     
  Lines        6069     6198     +129     
==========================================
+ Hits         5540     5655     +115     
- Misses        529      543      +14     

Flag	Coverage Δ
unittests	91.23% <82.05%> (-0.05%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.