UVCal Class

UVCal is the main user class for calibration solutions. It provides import and export functionality to all supported file formats (calfits) and can be interacted with directly.

class pyuvdata.UVCal[source]

A class defining calibration solutions.

Currently supported file types: calfits

UVParameter objects

(http://pyuvdata.readthedocs.io/en/latest/uvcal_parameters.html). Some are always required, some are required for certain cal_types and others are always optional.

Type

For full list see UVCal Parameters

set_gain()[source]

Set cal_type to ‘gain’ and adjust required parameters.

This method is deprecated, and will be removed in pyuvdata v2.2. Use _set_gain instead.

set_delay()[source]

Set cal_type to ‘delay’ and adjust required parameters.

This method is deprecated, and will be removed in pyuvdata v2.2. Use _set_delay instead.

set_unknown_cal_type()[source]

Set cal_type to ‘unknown’ and adjust required parameters.

This method is deprecated, and will be removed in pyuvdata v2.2. Use _set_unknown_cal_type instead.

set_sky()[source]

Set cal_style to ‘sky’ and adjust required parameters.

This method is deprecated, and will be removed in pyuvdata v2.2. Use _set_sky instead.

set_redundant()[source]

Set cal_style to ‘redundant’ and adjust required parameters.

This method is deprecated, and will be removed in pyuvdata v2.2. Use _set_redundant instead.

check(check_extra=True, run_check_acceptability=True)[source]

Add some extra checks on top of checks on UVBase class.

Check that required parameters exist. Check that parameters have appropriate shapes and optionally that the values are acceptable.

Parameters
  • check_extra (bool) – If true, check all parameters, otherwise only check required parameters.

  • run_check_acceptability (bool) – Option to check if values in parameters are acceptable.

Returns

bool – True if check passes

Raises

ValueError – if parameter shapes or types are wrong or do not have acceptable values (if run_check_acceptability is True)

ant2ind(antnum)[source]

Get the index in data arrays for an antenna number.

Parameters

antnum (int) – Antenna number to get index for.

Returns

int – Antenna index in data arrays.

jpol2ind(jpol)[source]

Get the index in data arrays for an antenna polarization.

Parameters

jpol (int or str) – Antenna polarization to get index for.

Returns

int – Antenna polarization index in data arrays

get_gains(ant, jpol=None, squeeze_pol=True)[source]

Get the gain associated with an antenna and/or polarization.

Parameters
  • ant (int or length 2 tuple of ints or int and str) – Antenna or antenna and polarization to get gains for. If it’s a length 2 tuple, the second value must be an antenna polarization int or string parsable by jpol2ind.

  • jpol (int or str, optional) – Instrumental polarization to request. Ex. ‘Jxx’

  • squeeze_pol (bool) – Option to squeeze pol dimension if possible.

Returns

complex ndarray – Gain solution of shape (Nfreqs, Ntimes, Npol) or (Nfreqs, Ntimes) if jpol is set or if squeeze_pol is True and Njones = 1.

get_flags(ant, jpol=None, squeeze_pol=True)[source]

Get the flags associated with an antenna and/or polarization.

Parameters
  • ant (int or length 2 tuple of ints or int and str) – Antenna or antenna and polarization to get gains for. If it’s a length 2 tuple, the second value must be an antenna polarization int or string parsable by jpol2ind.

  • jpol (int or str, optional) – Instrumental polarization to request. Ex. ‘Jxx’

  • squeeze_pol (bool) – Option to squeeze pol dimension if possible.

Returns

boolean ndarray – Flags of shape (Nfreqs, Ntimes, Npol) or (Nfreqs, Ntimes) if jpol is set or if squeeze_pol is True and Njones = 1.

get_quality(ant, jpol=None, squeeze_pol=True)[source]

Get the qualities associated with an antenna and/or polarization.

Parameters
  • ant (int or length 2 tuple of ints or int and str) – Antenna or antenna and polarization to get gains for. If it’s a length 2 tuple, the second value must be an antenna polarization int or string parsable by jpol2ind.

  • jpol (int or str, optional) – Instrumental polarization to request. Ex. ‘Jxx’

  • squeeze_pol (bool) – Option to squeeze pol dimension if possible.

Returns

float ndarray – Qualities of shape (Nfreqs, Ntimes, Npol) or (Nfreqs, Ntimes) if jpol is not None or if squeeze_pol is True and Njones = 1.

convert_to_gain(delay_convention='minus', run_check=True, check_extra=True, run_check_acceptability=True)[source]

Convert non-gain cal_types to gains.

For the delay cal_type the gain is calculated as:

gain = 1 * exp((+/-) * 2 * pi * j * delay * frequency) where the (+/-) is dictated by the delay_convention

Parameters
  • delay_convention (str) – Exponent sign to use in the conversion, can be “plus” or “minus”.

  • run_check (bool) – Option to check for the existence and proper shapes of parameters after converting.

  • check_extra (bool) – Option to check optional parameters as well as required ones.

  • run_check_acceptability (bool) – Option to check acceptable range of the values of parameters after converting.

select(antenna_nums=None, antenna_names=None, frequencies=None, freq_chans=None, times=None, jones=None, run_check=True, check_extra=True, run_check_acceptability=True, inplace=True)[source]

Downselect data to keep on the object along various axes.

Axes that can be selected along include antennas, frequencies, times and antenna polarization (jones).

The history attribute on the object will be updated to identify the operations performed.

Parameters
  • antenna_nums (array_like of int, optional) – The antennas numbers to keep in the object (antenna positions and names for the removed antennas will be retained). This cannot be provided if antenna_names is also provided.

  • antenna_names (array_like of str, optional) – The antennas names to keep in the object (antenna positions and names for the removed antennas will be retained). This cannot be provided if antenna_nums is also provided.

  • frequencies (array_like of float, optional) – The frequencies to keep in the object, each value passed here should exist in the freq_array.

  • freq_chans (array_like of int, optional) – The frequency channel numbers to keep in the object.

  • times (array_like of float, optional) – The times to keep in the object, each value passed here should exist in the time_array.

  • jones (array_like of int, optional) – The antenna polarizations numbers to keep in the object, each value passed here should exist in the jones_array.

  • run_check (bool) – Option to check for the existence and proper shapes of parameters after downselecting data on this object (the default is True, meaning the check will be run).

  • check_extra (bool) – Option to check optional parameters as well as required ones (the default is True, meaning the optional parameters will be checked).

  • run_check_acceptability (bool) – Option to check acceptable range of the values of parameters after downselecting data on this object (the default is True, meaning the acceptable range check will be done).

  • inplace (bool) – Option to perform the select directly on self or return a new UVCal object with just the selected data (the default is True, meaning the select will be done on self).

read_calfits(filename, run_check=True, check_extra=True, run_check_acceptability=True)[source]

Read in data from calfits file(s).

Parameters
  • filename (str or list of str) – The calfits file(s) to read from.

  • run_check (bool) – Option to check for the existence and proper shapes of parameters after reading in the file.

  • check_extra (bool) – Option to check optional parameters as well as required ones.

  • run_check_acceptability (bool) – Option to check acceptable range of the values of parameters after reading in the file.

read_fhd_cal(cal_file, obs_file, settings_file=None, raw=True, extra_history=None, run_check=True, check_extra=True, run_check_acceptability=True)[source]

Read data from an FHD cal.sav file.

Parameters
  • cal_file (str or list of str) – The cal.sav file or list of files to read from.

  • obs_file (str or list of str) – The obs.sav file or list of files to read from.

  • settings_file (str or list of str, optional) – The settings_file or list of files to read from. Optional, but very useful for provenance.

  • raw (bool) – Option to use the raw (per antenna, per frequency) solution or to use the fitted (polynomial over phase/amplitude) solution. Default is True (meaning use the raw solutions).

  • extra_history (str or list of str, optional) – String(s) to add to the object’s history parameter.

  • run_check (bool) – Option to check for the existence and proper shapes of parameters after reading in the file.

  • check_extra (bool) – Option to check optional parameters as well as required ones.

  • run_check_acceptability (bool) – Option to check acceptable range of the values of parameters after reading in the file.

write_calfits(filename, run_check=True, check_extra=True, run_check_acceptability=True, clobber=False)[source]

Write the data to a calfits file.

Parameters
  • filename (str) – The calfits file to write to.

  • run_check (bool) – Option to check for the existence and proper shapes of parameters before writing the file.

  • check_extra (bool) – Option to check optional parameters as well as required ones.

  • run_check_acceptability (bool) – Option to check acceptable range of the values of parameters before writing the file.

  • clobber (bool) – Option to overwrite the filename if the file already exists.