orca.calibration.bandpass_pipeline

Bandpass calibration pipeline.

This module provides the bandpass calibration pipeline for OVRO-LWA data. Processes multiple measurement sets at a given frequency and LST hour to produce a bandpass calibration table.

The pipeline:

  1. Copies MS files to NVMe for fast processing.

  2. Generates beam-based sky models and applies to each MS.

  3. Concatenates and fixes metadata issues.

  4. Flags RFI using AOFlagger and known bad antennas.

  5. Solves for bandpass using CASA bandpass task.

  6. Generates QA plots and archives results.

Example

>>> from orca.calibration.bandpass_pipeline import run_bandpass_calibration
>>> run_bandpass_calibration(ms_list, delay_table, '2024-01-15')

Functions

run_bandpass_calibration(→ str)

Run bandpass calibration for a frequency-hour block using NVMe.

Module Contents

orca.calibration.bandpass_pipeline.run_bandpass_calibration(ms_list, delay_table, obs_date, nvme_root='/fast/pipeline') → str[source]

Run bandpass calibration for a frequency-hour block using NVMe.

This function performs:

  1. Copies the 24 MS files to NVMe (e.g., /fast/pipeline/).

  2. Generates and applies a full-sky beam-based model to each MS.

  3. Concatenates the MS files and fixes FIELD_ID/OBSERVATION_ID.

  4. Sets the phase center to that of the central MS.

  5. Flags RFI using AOFlagger and known bad antennas.

  6. Performs CASA bandpass calibration using the provided delay table.

  7. Generates a QA PDF showing per-antenna bandpass amplitude/phase.

  8. Moves output to:

    /lustre/pipeline/calibration/bandpass/<FREQ>/<DATE>/<HOUR>/ with filename: bandpass_concat.<FREQ>_<HOUR>.bandpass

  9. Cleans up NVMe temporary space.

Parameters:

  • ms_list (list) – List of 24 Measurement Set (MS) paths (same freq/LST).

  • delay_table (str) – Path to the CASA delay calibration table.

  • obs_date (str) – Observation date in format ‘YYYY-MM-DD’.

  • nvme_root (str) – Root scratch directory on fast storage (/fast/pipeline by default).

Returns:

Full path to the bandpass table saved on Lustre.

Return type:

str