AntennaArray¶

class AntennaArray(name, position, antennas)[source]¶

Bases: object

A logical representation of the antenna array.

Parameters:

name (str)
position (dict)
antennas (list[Antenna])

antennas¶: List of Antenna objects that comprise the array.

baseline_lookup¶: 2D matrix of baseline lengths in metres, indexed by antenna ID.

baselines_m¶: 1D array of baseline lengths for unique antenna pairs (excluding auto-correlations).

baseline_min¶: Baseline namedtuple (antenna1, antenna2, length) for the shortest baseline, or None if fewer than two antennas.

baseline_max¶: Baseline namedtuple (antenna1, antenna2, length) for the longest baseline, or None if fewer than two antennas.

Attributes Summary

`elevation`	Get the array elevation as a CASA quantity.
`latitude`	Get the array latitude as a CASA quantity.
`longitude`	Get the array longitude as a CASA quantity.
`median_direction`	Return the median center direction for the array.
`name`	Return the name of the observatory.
`position`	Return the position of the observatory as a CASA 'position' measure dictionary.

Methods Summary

`baselines_for_antennas`(antenna_ids)	Return a list of Baseline tuples for input antenna IDs.
`get_antenna`([id, name])	Return Antenna object for given antenna ID or name.
`get_baseline`(antenna1, antenna2)	Get the baseline distance between two antennas.
`get_offset`(antenna)	Get the offset of the given antenna from the centre of the array.

Attributes Documentation

elevation¶: Get the array elevation as a CASA quantity.

latitude¶: Get the array latitude as a CASA quantity.

longitude¶: Get the array longitude as a CASA quantity.

median_direction¶

Return the median center direction for the array.

Returns:: Median center direction for the array as a CASA 'direction' measure dictionary.

name¶: Return the name of the observatory.

position¶: Return the position of the observatory as a CASA 'position' measure dictionary.

Methods Documentation

baselines_for_antennas(antenna_ids)[source]¶

Return a list of Baseline tuples for input antenna IDs.

This creates and returns a list of Baseline tuples for combinations of unique IDs in input antenna IDs.

Parameters:: antenna_ids (Sequence[int]) -- IDs of antennas to return baselines for.
Returns:: List of Baseline objects.
Return type:: list[Baseline]

get_antenna(id=None, name=None)[source]¶

Return Antenna object for given antenna ID or name.

If both ID and name are given, the antenna is searched for by ID.

Parameters:

id (int | None) -- Antenna ID to search for.
name (str | None) -- Antenna name to search for.

Returns:

Antenna object for given antenna ID or name.

Raises:

Exception, if no id or name are given. --

Return type:

Antenna

get_baseline(antenna1, antenna2)[source]¶

Get the baseline distance between two antennas.

Antenna identifiers will be considered first as numeric antenna IDs, then as antenna names.

Parameters:

antenna1 (int | str) -- Numerical ID or name of first antenna.
antenna2 (int | str) -- Numerical ID or name of second antenna.

Returns:

The baseline length in meters between antennass identified by arguments antenna1 and antenna2. If an identifier does not match a known antenna, None will be returned.

Return type:

Baseline | None

get_offset(antenna)[source]¶

Get the offset of the given antenna from the centre of the array.

Parameters:: antenna (Antenna) -- Antenna object to determine offset for.
Returns:: 2-tuple containing x- and y-offset to centre of the array.
Return type:: tuple[Distance, Distance]