orca.transform.pb_correction
============================

.. py:module:: orca.transform.pb_correction

.. autoapi-nested-parse::

   Primary beam correction for OVRO-LWA FITS images.

   Uses the ``extractor_pb_75`` package (installed on the calim cluster) to
   apply a beam model correction.  The beam model H5 path is taken from
   :mod:`orca.resources.subband_config`.

   Ported from the standalone ``pb_correct.py`` script into the orca package.



Attributes
----------

.. autoapisummary::

   orca.transform.pb_correction.logger


Functions
---------

.. autoapisummary::

   orca.transform.pb_correction.apply_pb_correction


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

.. py:data:: logger

.. py:function:: apply_pb_correction(fits_path: str) -> Optional[str]

   Apply primary beam correction and save a new ``.pbcorr.fits`` file.

   Does NOT overwrite the original.  Checks the header ``PBCORR`` keyword
   to prevent double-application.

   :param fits_path: Path to the input FITS image.

   :returns: Path to the corrected output file, or *None* on failure / skip.