astrohack.extract_locit
¶
Module Contents¶
Functions¶
|
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
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.