astrohack.extract_locit

Module Contents

Functions

extract_locit(cal_table: str, locit_name: str = None, ant: Union[str, List[str]] = 'all', ddi: Union[int, List[int]] = 'all', overwrite: bool = False)

Extract Antenna position determination data from an MS and stores it in a locit output file.

extract_locit(cal_table: str, locit_name: str = None, ant: Union[str, List[str]] = 'all', ddi: Union[int, List[int]] = 'all', overwrite: bool = False)[source]

Extract Antenna position determination data from an MS and stores it in a locit output file.

Parameters
  • cal_table (str) – Name of input measurement file name.

  • locit_name (str, optional) – Name of <locit_name>.locit.zarr file to create. Defaults to measurement set name with locit.zarr extension.

  • ant (list or str, optional) – List of antennas/antenna to be extracted, defaults to “all” when None, ex. ea25

  • ddi (list or int, optional) – List of ddi to be extracted, defaults to “all” when None, ex. 0

  • overwrite (bool, optional) – Boolean for whether to overwrite current locit.zarr file, defaults to False.

Returns

Antenna position locit object.

Return type

AstrohackLocitFile

extract_locit is a tool to extract the phase gains from a calibration table in an order that is suited for parallelized processing by locit. Along with the calibration data antenna position and source position information is extracted from the calibration table for use in the fitting process in locit.

AstrohackLocitFile The locit object allows the user to access calibration data via compound dictionary keys with values, in order of depth, ant -> ddi. The locit object also provides a summary() helper function to list available keys for each file. An outline of the locit object structure is show below:

locit_mds =
{
    ant_0:{
        ddi_0: locit_ds,
         ⋮
        ddi_m: locit_ds
    },
    ⋮
    ant_n: …
}

Examples

  • locit_mds = extract_locit(“myphase.cal”, locit_name=”myphase.locit.zarr”) -> Extract phase calibration data for

    all antennas and all DDIs in “myphase.cal” into a locit file called “myphase.locit.zarr”

  • `locit_mds = extract_locit(“myphase.cal”, ant=[“ea06”, “ea03”, “ea25”], DDI=0, overwrite=True) -> Extract phase

    calibration data for DDI 0 of antennas ea06, ea03 and ea25 in “myphase.cal” into a locit file called “myphase.locit.zarr” that will be overwritten if already present.