orca.resources.subband_config
=============================

.. py:module:: orca.resources.subband_config

.. autoapi-nested-parse::

   Subband processing configuration for OVRO-LWA pipeline.

   Contains node-to-subband mapping, imaging parameters, reference file paths,
   and all configuration needed by the subband processing Celery tasks.

   All settings live within the orca package for use with the Celery-based
   subband pipeline.



Attributes
----------

.. autoapisummary::

   orca.resources.subband_config.OVRO_LOC
   orca.resources.subband_config.REQUIRED_CONDA_ENV
   orca.resources.subband_config.NODE_SUBBAND_MAP
   orca.resources.subband_config.SUBBAND_NODE_MAP
   orca.resources.subband_config.CALIM_NODES
   orca.resources.subband_config.DYNAMIC_NODE_POOL
   orca.resources.subband_config.NVME_BASE_DIR
   orca.resources.subband_config.LUSTRE_ARCHIVE_DIR
   orca.resources.subband_config.LUSTRE_NIGHTTIME_DIR
   orca.resources.subband_config.LUSTRE_PRODUCTS_DIR
   orca.resources.subband_config.PEELING_PARAMS
   orca.resources.subband_config.AOFLAGGER_STRATEGY
   orca.resources.subband_config.VLSSR_CATALOG
   orca.resources.subband_config.BEAM_MODEL_H5
   orca.resources.subband_config.CALIB_DATA
   orca.resources.subband_config.HOT_BASELINE_PARAMS
   orca.resources.subband_config.SNAPSHOT_PARAMS
   orca.resources.subband_config.SNAPSHOT_CLEAN_I_PARAMS
   orca.resources.subband_config.IMAGING_STEPS


Functions
---------

.. autoapisummary::

   orca.resources.subband_config.get_queue_for_subband
   orca.resources.subband_config.get_pixel_size
   orca.resources.subband_config.get_pixel_scale
   orca.resources.subband_config.get_image_resources


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

.. py:data:: OVRO_LOC

.. py:data:: REQUIRED_CONDA_ENV
   :value: 'py38_orca_nkosogor'


.. py:data:: NODE_SUBBAND_MAP

.. py:data:: SUBBAND_NODE_MAP

.. py:data:: CALIM_NODES

.. py:data:: DYNAMIC_NODE_POOL
   :value: ['calim00', 'calim01', 'calim03', 'calim04', 'calim05', 'calim06', 'calim07', 'calim08', 'calim09']


.. py:function:: get_queue_for_subband(subband: str) -> str

   Return the Celery queue name for a given subband.

   :param subband: e.g. '73MHz'

   :returns: Queue name, e.g. 'calim08'


.. py:data:: NVME_BASE_DIR
   :value: '/fast/pipeline'


.. py:data:: LUSTRE_ARCHIVE_DIR
   :value: '/lustre/pipeline/images'


.. py:data:: LUSTRE_NIGHTTIME_DIR
   :value: '/lustre/pipeline/night-time/averaged'


.. py:data:: LUSTRE_PRODUCTS_DIR
   :value: '/lustre/pipeline/products'


.. py:data:: PEELING_PARAMS

.. py:data:: AOFLAGGER_STRATEGY
   :value: '/lustre/ghellbourg/AOFlagger_strat_opt/LWA_opt_GH1.lua'


.. py:data:: VLSSR_CATALOG
   :value: '/lustre/gh/calibration/pipeline/reference/surveys/FullVLSSCatalog.text'


.. py:data:: BEAM_MODEL_H5
   :value: '/lustre/gh/calibration/pipeline/reference/beams/OVRO-LWA_MROsoil_updatedheight.h5'


.. py:data:: CALIB_DATA

.. py:data:: HOT_BASELINE_PARAMS

.. py:data:: SNAPSHOT_PARAMS

.. py:data:: SNAPSHOT_CLEAN_I_PARAMS

.. py:data:: IMAGING_STEPS

.. py:function:: get_pixel_size(subband: str) -> int

   Return the image pixel dimension for a given subband.

   Lower subbands use fewer pixels (wider beam → coarser resolution):
     18-36 MHz  →  1024  (4096/4)
     41-59 MHz  →  2048  (4096/2)
     64-82 MHz  →  4096

   :param subband: e.g. '55MHz'

   :returns: NxN).
   :rtype: Pixel dimension (square images


.. py:function:: get_pixel_scale(subband: str) -> float

   Return the pixel scale (deg/pixel) paired with :func:`get_pixel_size`.

   The product ``get_pixel_size(sb) * get_pixel_scale(sb)`` is constant
   (~128°) so that the field-of-view is preserved across frequency tiers.

     18-36 MHz  →  0.125    (0.03125 * 4)
     41-59 MHz  →  0.0625   (0.03125 * 2)
     64-82 MHz  →  0.03125

   :param subband: e.g. '55MHz'

   :returns: Pixel scale in degrees.


.. py:function:: get_image_resources(subband: str)

   Return (cpus, mem_gb, wsclean_j) for a given subband.

   In dynamic dispatch mode any subband can land on any node, so we
   always allocate full node resources (44 cores).  The old dual-node
   halving (22 cores) is no longer used.

   :param subband: e.g. '73MHz'

   :returns: int, mem_gb: int, wsclean_j: int).
   :rtype: Tuple of (cpus