orca.transform.precalflag
=========================

.. py:module:: orca.transform.precalflag

.. autoapi-nested-parse::

   Pre-calibration flagging based on autocorrelation power.

   Identifies dead or malfunctioning antennas before calibration by
   analyzing autocorrelation power levels relative to the array median.

   Functions
   ---------
   is_fft_overflow
       Check for FFT overflow conditions (not yet implemented).
   find_dead_ants
       Identify antennas with abnormally low power.



Attributes
----------

.. autoapisummary::

   orca.transform.precalflag.logger
   orca.transform.precalflag.DEAD_POWER_THRESHOLD


Functions
---------

.. autoapisummary::

   orca.transform.precalflag.is_fft_overflow
   orca.transform.precalflag.find_dead_ants


Module Contents
---------------

.. py:data:: logger

.. py:data:: DEAD_POWER_THRESHOLD
   :value: 0.1


.. py:function:: is_fft_overflow(ms: str) -> bool

   Check if the measurement set shows signs of FFT overflow.

   :param ms: Path to the measurement set.

   :returns: True if overflow detected, False otherwise.

   :raises NotImplementedError: Function not yet implemented.


.. py:function:: find_dead_ants(ms: str) -> List[int]

   Identify antennas with abnormally low power.

   Compares each antenna's total autocorrelation power to the array
   median for core and outrigger antennas separately.

   :param ms: Path to the measurement set.

   :returns: Sorted list of antenna indices with power below threshold.