Source code for pipeline.hifa.cli.hifa_lock_refant

import pipeline.h.cli.utils as utils


# docstring and type hints: inherits from hifa.tasks.lock_refant.lock_refant.LockRefAntInputs.__init__


@utils.cli_wrapper
def hifa_lock_refant(vis=None):
    """Lock the reference antenna to a single antenna with ``refantmode='fixed'``.

    Sets the reference antenna to a single antenna and sets ``refantmode='fixed'`` for all subsequent
    calibration tasks, preventing any subsequent modification of the refant list.

    In the polarization (polcal and polcalimage) recipes, `hifa_bandpass` and `hifa_spwphaseup` are each
    called a second time after this stage to ensure those calibration tables are computed using the fixed
    reference antenna.

    The refant list can be unlocked with the `hifa_unlock_refant` task, although that is not needed in the
    standard polcal and polcalimage recipes.

    Notes:
        Only used in polarization recipes.

    Returns:
        The results object for the pipeline task is returned.

    Examples:
        1. Lock the refant list for all MSes in pipeline context:

        >>> hifa_lock_refant()

    """