orca.transform.flux_check_cutout
================================

.. py:module:: orca.transform.flux_check_cutout

.. autoapi-nested-parse::

   OVRO-LWA Flux Scale Validation.

   Ported from ExoPipe/flux_check_cutout.py into the orca package for
   use with the Celery pipeline.

   Validates the absolute flux scale of calibrated images against
   Scaife & Heald (2012) models using CASA imfit on cutouts around
   known calibrators.



Attributes
----------

.. autoapisummary::

   orca.transform.flux_check_cutout.CASA_TASKS_AVAILABLE
   orca.transform.flux_check_cutout.CASA_TASKS_AVAILABLE
   orca.transform.flux_check_cutout.CUTOUT_SIZE
   orca.transform.flux_check_cutout.SEARCH_RADIUS
   orca.transform.flux_check_cutout.MIN_ELEVATION


Functions
---------

.. autoapisummary::

   orca.transform.flux_check_cutout.get_model_flux
   orca.transform.flux_check_cutout.process_cutout
   orca.transform.flux_check_cutout.run_flux_check


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

.. py:data:: CASA_TASKS_AVAILABLE
   :value: False


.. py:data:: CASA_TASKS_AVAILABLE
   :value: True


.. py:data:: CUTOUT_SIZE

.. py:data:: SEARCH_RADIUS

.. py:data:: MIN_ELEVATION
   :value: 20.0


.. py:function:: get_model_flux(name, freq_mhz)

   Predict flux density of a calibrator at given frequency.

   Uses Scaife & Heald (2012) polynomial coefficients stored in
   ``CALIB_DATA``.  The reference frequency is 150 MHz.


.. py:function:: process_cutout(img_path, source_name, source_data, temp_dir)

   Create a cutout around *source_name* and fit with ``imfit``.


.. py:function:: run_flux_check(run_dir, logger=None)

   Validate absolute flux scale against SH12 models.

   :param run_dir: Root directory for the subband run (contains ``<freq>MHz/`` folders).
   :type run_dir: str
   :param logger: If supplied, messages go through ``logger.info`` etc.
   :type logger: logging.Logger, optional