Skip to content

docs: retire deleted TransformerNUFFTPyNUFFT from interferometer docs - #225

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/pynufft-removal-residue-phase-2
Aug 23, 2026
Merged

docs: retire deleted TransformerNUFFTPyNUFFT from interferometer docs#225
Jammy2211 merged 1 commit into
mainfrom
feature/pynufft-removal-residue-phase-2

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Retires TransformerNUFFTPyNUFFT — deleted by PyAutoLabs/PyAutoArray#475 — from this workspace's interferometer docs.

Why this repo was missed: the removal task scoped its workspace tier to autolens_workspace (fixed in PyAutoLabs/autolens_workspace#497) and autolens_workspace_test. autogalaxy_workspace is the direct sibling and was never swept. Wording here mirrors #497, adapted to the galaxy context.

Scripts Changed

Script Change
scripts/interferometer/start_here.py Drop the TransformerNUFFTPyNUFFT fallback line; correct the stale claim that TransformerNUFFT "is not JAX-traceable" and that nufftax is "a research path"
scripts/interferometer/simulator.py Drop the dangling "only the legacy pynufft-backed … is not" clause
scripts/interferometer/features/linear_light_profiles/modeling.py Replace the legacy-fallback sentence with the accurate Intel-macOS guidance
scripts/guides/using_jax.py Same; keep the defaults-differ-by-class note
start_here.py PyNUFFT link → nufftax

notebooks/** regenerated via generate.py autogalaxy; never hand-edited. workspace_index.json changed only because a cross-reference to autolens_workspace_test/scripts/interferometer/nufft.py was removed with its sentence.

The stale claim worth flagging

scripts/interferometer/start_here.py still told users TransformerNUFFT "is not JAX-traceable" and that nufftax was a "research path tracking that". Both predate nufftax shipping as the default backend. The autolens sibling has said the opposite since #497 — the two workspaces contradicted each other.

Intel macOS

Where a genuine non-JAX fallback is needed the docs now name TransformerDFT (exact, pure-numpy, O(N_vis × N_pix)), matching the decision recorded in the removal task: jaxlib's last Intel-macOS wheel is 0.4.38 and there is no sdist, so those users keep DFT only.

markdown/ deliberately NOT regenerated

generate_markdown.py executes curated scripts for real, and its own documented policy is "manual / at-release, only when a curated script changes — never per-commit." Three curated pages are affected (start_here, interferometer/start_here, interferometer/simulator) and will refresh at the next release. They still contain the stale text until then.

Validation

  • scripts/check_sizes.sh: OK — no changed script shrank >50%.
  • Alias-aware sweep: 0 executable references to the deleted class.
  • paper/ untouched (published JOSS record) — confirmed by git diff --stat.

Note for the reviewer

Heart was RED (release validation FAILED, unrelated) at PR-open; the human explicitly authorized push + PR-open. Merge remains gated.

Refs #224

PyAutoArray#475 deleted TransformerNUFFTPyNUFFT, but these scripts still
advertised it as an available 'non-JAX fallback'. autogalaxy_workspace is the
sibling of autolens_workspace, fixed in autolens_workspace#497; it was never
swept. Wording mirrors #497, adapted to the galaxy context.

Also corrects scripts/interferometer/start_here.py, which still claimed
TransformerNUFFT 'is not JAX-traceable' and called nufftax 'a research path' --
both stale since nufftax shipped as the default backend.

The Intel-macOS fallback is now stated accurately: use TransformerDFT (exact,
pure-numpy, O(N_vis x N_pix)) where JAX has no wheels.

notebooks/ regenerated via generate.py. markdown/ deliberately NOT regenerated:
generate_markdown.py executes curated scripts for real and its documented policy
is 'manual / at-release, only when a curated script changes -- never
per-commit'. Three curated pages (start_here, interferometer/start_here,
interferometer/simulator) are affected and will refresh at the next release.

Refs #224

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JEXzQpvG3QNUdTh6tZcaAE
@Jammy2211 Jammy2211 added the pending-release PR queued for the next release build label Aug 23, 2026
@Jammy2211
Jammy2211 merged commit 1252053 into main Aug 23, 2026
7 checks passed
@Jammy2211
Jammy2211 deleted the feature/pynufft-removal-residue-phase-2 branch August 23, 2026 22:14
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