auto_selfcal: Self-calibration, without the hassle!

auto_selfcal does automatic self-calibration of ALMA and VLA with (almost) no effort from you. It can handle most forms of data, including single pointing and ALMA mosaics (VLA mosaics coming soon), ephemeris data, spectral scans, and more. See below to give it a try, or check out our more extensive documentation at https://auto-selfcal.readthedocs.io.

Quickstart

To use auto_selfcal with an existing monolithic CASA distribution:

git clone https://github.com/jjtobin/auto_selfcal.git

cd </path/to/pipeline/calibrated/*_targets.ms/files>

casa -c </path/to/auto_selfcal>/bin/auto_selfcal.py

Or to install into an existing Python environment (note that a Python version for which CASA is available is required) and run from a directory where pipeline-calibrated *_targets.ms files exist:

pip install auto-selfcal

cd </path/to/pipeline/calibrated/*_targets.ms/files>

auto_selfcal

Acknowledging auto_selfcal

Love auto_selfcal and want to cite it? Please use:

@software{auto_selfcal,
    author       = {John J. Tobin and Patrick Sheehan and Rui Xue and Ryan Loomis and Austen Fourkas and Samuel Fielder},
    title        = {jjtobin/auto\_selfcal: v2.1.0},
    month        = apr,
    year         = 2026,
    publisher    = {Zenodo},
    version      = {v2.1.0},
    doi          = {10.5281/zenodo.17871742},
    url          = {https://doi.org/10.5281/zenodo.17871742},
}

Acknowledgements:

Certain functions to convert from LSRK to channel, S/N estimates, and tclean wrapper have their origins from the ALMA DSHARP large program reduction scripts.

The functions to parse the cont.dat file and convert to channel ranges (used the routine from above) was adapted from a function written by Patrick Sheehan for the ALMA eDisk large program

The EB-alignment functionality is based off of scripts kindly donated by the exoALMA Large Program, described in exoALMA II: Data Calibration and Imaging Pipeline.