Skip to content

Add more control over multiscale clean scales#362

Open
thomaswilliamsastro wants to merge 1 commit into
masterfrom
multiscale-beam-scales
Open

Add more control over multiscale clean scales#362
thomaswilliamsastro wants to merge 1 commit into
masterfrom
multiscale-beam-scales

Conversation

@thomaswilliamsastro

@thomaswilliamsastro thomaswilliamsastro commented Jun 24, 2026

Copy link
Copy Markdown
Collaborator

Fixes #270

This PR adds two new options for setting multiscale clean scales, clean_scales_beam and clean_scales_auto.

The list clean_scales_beam option allows you to define clean scales as multiples of the beam. If both clean_scales_beam and clean_scales_arcsec are defined, then these will be both be used to form a single list of clean scales.

The boolean clean_scales_auto option, allows for fully automatic setting of the clean scales based on the beam and the LAS of the data. If this is set to True, then will add scales of [0, beam FWHM], then continue multiplying by clean_scales_auto_factor (default 2) up to clean_scales_max_las_fraction * the LAS of the data (default 1). Note that setting this will override clean_scales_arcsec and clean_scales_beam.

  • Add clean_scales_beam
  • Add clean_scales_auto
  • If available, pull beam size from image, or fall back to calculating from visibilities
  • Clean scales are now rounded, rather than simply cast to int
  • Update docs
  • Update CHANGELOG

@codecov

codecov Bot commented Jun 24, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 10.89109% with 90 lines in your changes missing coverage. Please review.
✅ Project coverage is 6.30%. Comparing base (b90495d) to head (ed287da).
✅ All tests successful. No failed tests found.

Files with missing lines Patch % Lines
phangsPipeline/clean_call.py 10.90% 49 Missing ⚠️
phangsPipeline/handlerKeys.py 11.62% 38 Missing ⚠️
phangsPipeline/handlerImaging.py 0.00% 2 Missing ⚠️
phangsPipeline/handlerImagingChunked.py 0.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff            @@
##           master    #362      +/-   ##
=========================================
+ Coverage    6.28%   6.30%   +0.02%     
=========================================
  Files          38      38              
  Lines       15209   15297      +88     
  Branches     3654    3674      +20     
=========================================
+ Hits          956     965       +9     
- Misses      14239   14318      +79     
  Partials       14      14              

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

@thomaswilliamsastro thomaswilliamsastro force-pushed the multiscale-beam-scales branch 2 times, most recently from 59ed5a6 to ebf201b Compare June 24, 2026 14:29
@thomaswilliamsastro thomaswilliamsastro marked this pull request as draft June 30, 2026 13:22
@thomaswilliamsastro

Copy link
Copy Markdown
Collaborator Author

Moving this back to draft following useful feedback at ADR today

@thomaswilliamsastro

Copy link
Copy Markdown
Collaborator Author

Beam is now pulled from image if available, exposed the important controls for the automatic clean scale setting, and docs updated

@low-sky ready for review!

@thomaswilliamsastro thomaswilliamsastro marked this pull request as ready for review July 1, 2026 09:58
This PR adds two new options for setting multiscale clean scales, ``clean_scales_beam`` and ``clean_scales_auto``.

The list ``clean_scales_beam`` option allows you to define clean scales as multiples of the beam. If both ``clean_scales_beam`` and ``clean_scales_arcsec`` are defined, then these will be both be used to form a single list of clean scales.

The boolean ``clean_scales_auto`` option, allows for fully automatic setting of the clean scales based on the beam and the LAS of the data. If this is set to True, then will add scales of [0, beam FWHM], then continue multiplying by ``clean_scales_auto_factor`` (default 2) up to ``clean_scales_max_las_fraction`` * the LAS of the data (default 1). Note that setting this will override ``clean_scales_arcsec`` and ``clean_scales_beam``.

- Add ``clean_scales_beam``
- Add ``clean_scales_auto``
- If available, pull beam size from image, or fall back to calculating from visibilities
- Clean scales are now rounded, rather than simply cast to int
- Update docs
- Update CHANGELOG
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add clean scales as ratios of the beam size

1 participant