Skip to content

docs: __PSF Convolution__ section across simulator.py examples#124

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/psf-convolution-docstring
Jul 10, 2026
Merged

docs: __PSF Convolution__ section across simulator.py examples#124
Jammy2211 merged 1 commit into
mainfrom
feature/psf-convolution-docstring

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Overview

Mirrors autolens_workspace #257/#258. Normalizes how PSF convolution / convolve_over_sample_size is documented across every simulator.py example.

  • imaging/simulator.py (the start-here reference) gains a __PSF Convolution__ docstring section, added to __Contents__, with an over-sample note as docstring prose (galaxy terminology).
  • Every other simulator with a real-space Gaussian PSF gains convolve_over_sample_size=1 as the first argument to from_gaussian(...) — no extra prose.
  • Interferometer simulators have no real-space PSF and are out of scope.

Notebooks and the navigator catalogue were regenerated from the scripts.

Scripts Changed

  • scripts/ellipse/simulator.py
  • scripts/guides/plot/simulator.py
  • scripts/imaging/features/extra_galaxies/simulator.py
  • scripts/imaging/features/multi_gaussian_expansion/simulator.py
  • scripts/imaging/features/operated_light_profile/simulator.py
  • scripts/imaging/features/pixelization/simulator.py
  • scripts/imaging/features/sky_background/simulator.py
  • scripts/imaging/simulator.py
  • scripts/multi/features/dataset_offsets/simulator.py
  • scripts/multi/features/same_wavelength/simulator.py
  • scripts/multi/features/wavelength_dependence/simulator.py
  • scripts/multi/simulator.py

Refs PyAutoLabs/autolens_workspace#257.

Normalize how PSF convolution / convolve_over_sample_size is documented across
every simulator.py example.

- imaging/simulator.py (the start-here reference) gains a __PSF Convolution__
  docstring section, added to __Contents__, with the over-sample note written as
  docstring prose (galaxy terminology).
- All other simulators with a real-space Gaussian PSF gain
  convolve_over_sample_size=1 as the first argument to from_gaussian(...), with
  no extra prose (users are assumed to have read the base simulator.py).

Regenerated notebooks and the navigator catalogue. Mirrors autolens_workspace #257.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Jammy2211 Jammy2211 added the pending-release PR queued for the next release build label Jul 10, 2026
@Jammy2211 Jammy2211 merged commit 67b3aa2 into main Jul 10, 2026
8 checks passed
@Jammy2211 Jammy2211 deleted the feature/psf-convolution-docstring branch July 10, 2026 08:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pending-release PR queued for the next release build

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant