orca.transform.solar_system_cutout
==================================

.. py:module:: orca.transform.solar_system_cutout

.. autoapi-nested-parse::

   OVRO-LWA Solar System Body Photometry.

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

   Computes ephemerides for major solar system bodies and extracts
   Stokes I + V cutouts from per-subband images.

   Bodies: Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune



Attributes
----------

.. autoapisummary::

   orca.transform.solar_system_cutout.CASA_AVAILABLE
   orca.transform.solar_system_cutout.SOLAR_SYSTEM_BODIES
   orca.transform.solar_system_cutout.SAMPLE_NAME
   orca.transform.solar_system_cutout.DETECTION_SIGMA
   orca.transform.solar_system_cutout.ANGULAR_DIAMETER_1AU
   orca.transform.solar_system_cutout.MOON_MEAN_DIAMETER_ARCSEC
   orca.transform.solar_system_cutout.MOON_MEAN_DISTANCE_KM


Functions
---------

.. autoapisummary::

   orca.transform.solar_system_cutout.get_obs_midpoint
   orca.transform.solar_system_cutout.get_body_position
   orca.transform.solar_system_cutout.get_timestamp_from_header
   orca.transform.solar_system_cutout.find_solar_system_images
   orca.transform.solar_system_cutout.process_solar_system
   orca.transform.solar_system_cutout.process_wideband_solar_system


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

.. py:data:: CASA_AVAILABLE
   :value: True


.. py:data:: SOLAR_SYSTEM_BODIES
   :value: ['moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune']


.. py:data:: SAMPLE_NAME
   :value: 'SolarSystem'


.. py:data:: DETECTION_SIGMA
   :value: 5.0


.. py:data:: ANGULAR_DIAMETER_1AU

.. py:data:: MOON_MEAN_DIAMETER_ARCSEC
   :value: 1865.0


.. py:data:: MOON_MEAN_DISTANCE_KM
   :value: 384400.0


.. py:function:: get_obs_midpoint(header)

   Extract observation midpoint from FITS header.


.. py:function:: get_body_position(body_name, obs_time, location)

   Compute ICRS position, elevation, and distance of a solar system body.


.. py:function:: get_timestamp_from_header(header)

.. py:function:: find_solar_system_images(run_dir, fallback_dir=None)

   Find all Stokes I + V image pairs for solar system cutouts.

   Returns list of (freq_mhz, category, i_path, v_path) tuples.


.. py:function:: process_solar_system(run_dir, out_dir, detections_dir, fallback_dir=None, logger=None)

   Main entry point: extract cutouts for all solar system bodies.


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

   Extract solar system cutouts from wideband stacked images.

   Called from :func:`orca.transform.post_process_science.run_post_processing`
   after wideband stacking is complete.

   Looks for ``Wideband_*_I_deep_*.fits`` and matching V files in *run_dir*.