2023 goals:

1. SRDP spring release to promote new capability
2. Fall 2023
   1. heuristic extensions
   2. weblog cleanup
   3. facilitate use for manual imaging scenarios that require selfcal  - gain real world testing benchmarks
3. Fall 2024 - include in operational pipeline?

Necessary for SRDP release

1. datatype awareness for hif_editimlist
2. need regcal and selfcal aggcont and cube images created and exported
3. Print pre/post beam info in per-solint table
4. skip mosaics implicitly
5. 3 digits past decimal for all values
6. Fix beam comparision ratios in per-solint stats
7. Change in nterms for high S/N sources for hif_makeimages

Post-SRDP Release (for Fall 2023)

Selfcal heuristics

• selfcal should reject pipeline mitigations internally
  • agg. cont self-calibration should use full image size and pixels per beam (model creation could be compromised otherwise)
  • perform self-calibration even for mitigated sources - extremely beneficial from archival point of view
• Implement low S/N and long baseline heuristics from PS (https://github.com/psheehan/auto_selfcal/tree/lbimprovements)
• Implement mosaic heuristics from PS (https://github.com/psheehan/auto_selfcal/tree/lbimprovements%2Bmosaics%2Bcocal)
• Possible improvement
  • uv-plane determination if a source is detectable in field of view
  • enable inclusion/exclusion in hif_selfcal
• Expose all relevant parameters
• Reference antenna determination cleaned up
  • VLA and ALMA use pipieline function to determine the refant list, not the function from prototype

QA & messages

•  Fix and suppress some warnings
  • "channel bandwidths ratio?" => see is the result of averaging down to 15.625 MHz channels when there was pre-averaging
  • suppress representative target warnings
• main table:
  • solints to attempt - make the successful solints bolded
  • Mouseover text for success (define as: 'self-calibration solutions accepted for at least one solution interval')
  • Remove phasecenter, cellsize, and imsize from table
  • Remove the 'apply contline' and 'apply cont' columns. If those fail as part of the task, the entire task should fail.
  • Add stop reason to table

Main page and results table:

• the page navigation with expanding sections is not used anywhere else and will be very unfamiliar - some of it is better than what is used elsewhere, but either way we should be more consistent
  • at the very least the buttons that expand alternative sections should have little "v" down arrow, or something indicating that they'll expand.
    or more consistent with the rest of the weblog would be to put all that on a subpage.
  • Some preference for this to open a new page
• Need 'View Other QA images'-type page page to show model, residual, mask, PB, and PSF. Does not need to exactly mirror iter0, iter1 of pipeline, but should show the necessary details for each image.
• the weird 3-dot, 3-line symbol at the start of the line is that takes you back up to the top - probably just ditch that for now or have explicit ('jump to top text')
• add mouseover text to Dist./Ratio that defines what this column is
• theoretical sensitivity should be plotted as filled, dark gray distribution rather than the horizontal bar, this will fix many issues with the current horizontal bar
• success "yes" looks like a clickable link but it isn't
• down the line it would be good to figure out how to display the large table of numbers graphically - its a lot of numbers to digest.  Or as a first step highlight table cells that indicate something interesting or potentially troubling is hapenning
• the table rendering is joining columns that probably shouldn't be joined, like "rms improvement" and "ratio of beam area" when they're both 1.0
• need to add residual and possibly model images
• 'N.F.' → 'Near Field' and abbreviation needs a mouse-over definition
• I would put stop reason higher
• General comment: Do not abbreviate words if space is available.

QA Plots subpages:

• Need the "BACK" button like other subpages,
• The weird symbol with three dots and three lines doesn't seem to do anything except randomly port me somewhat upwards on the page, remove or make explicit what it does
• Passed "Yes" again is a link that doesn't do anything when clicked
• "Sol summary" needs better explanation
  
  • sol. Summary - > selfcal solution interval summary
  • 'Sol.' in row names → Solutions
• Need 'View Other QA images'-type page page to show model, residual, mask, PB, and psf.
• The prior/post plots should show the same information per solint that is shown on the main page for consistency.

• RAL: phase plots need to have consistent scale to be useful as thumbnails.
• RAL: 'Comparison' plot and stats missing here

• Assess S/N ratio in the visibility plane

Stop reporting:

• Make summary table
  
  • After selfcal task, a brief summary should be written to the CASA log for selfcal that should mirror the summary table at the top
    • Start with 'Begin Selfcal Summary...'
    • List target, band, last successful solint, stop reason (comma separated)
    • End with 'End Selfcal Summary.'
  • Something similar would be useful for the AQUA report, ALMA will need to define what they need.

Proposed QA metrics

• S/N and RMS metrics
  • overall S/N increased, but near-field S/N decreases
  • S/N increases, but RMS increases
  • S/N decreases and RMS decreases
  • reductions in S/N for some prior/post per-spw images ( if we decide we want to be making these)
• Flagging metrics
  • Excessive flagging on certain EBs
    • most relevant to many EB datasets where a couple EBs with lots of failed solutions would not result in beam changing significantly
  • beam size increases (within the allowed 5%)
  • Number of long baseline antennas flagged (and passed through)
• Calibration metrics
  • Multiple reference antenna changes on final accepted solution interval in gaincal
  • Large phase corrections on >2 antennas
    • Define large (> 90 deg?)
    • Separate determination for inf_EB and inf
      • inf_EB - system issues
      • inf - phase decorrelation