tkp.telescope
– Telescope specific functionality¶
tkp.telescope.lofar
¶
Functions for calculating LOFAR hardware specific properties.
This module contains numbers of phsysicial properties of the LOFAR array.
For performance reasons these distances are precomputed. One can recompute
them using parse_antennafile()
, shortest_distances()
and a
AntennaArrays.conf
file from
LOFAR/MAC/Deployment/data/StaticMetaData/AntennaArrays
in the lofar system
software source tree.

tkp.telescope.lofar.antennaarrays.
parse_antennafile
(positions_file)[source]¶ Parses an antenna file from the LOFAR system software repository.
Parameters: positions_file – a antenna file Returns: a dictionary with array as key and positions as values

tkp.telescope.lofar.antennaarrays.
pretty_print
(file_)[source]¶ Pretty prints a parsed antenna file. Use this function to generate copy paste code to be used in the top of this file.
Parameters: file – a file location

tkp.telescope.lofar.antennaarrays.
shortest_distances
(coordinates, full_array)[source]¶ returns a list of distances for each antenna relative to its closest neighbour.
Parameters:  coordinates – a list of 3 value tuples that represent x,y and z coordinates of a subset of the array
 full_array – a list of x,y,z coordinates of a full array
Returns: a list of floats of distances
Beam characterization calculations.
For more information and the math behind this code go to the LOFAR imaging capabilities page.

tkp.telescope.lofar.beam.
fov
(fwhm)[source]¶ The Field of View (FoV) of a LOFAR station
Parameters: fwhm – nominal Full Width Half Maximum, caulculated with fwhm()
.

tkp.telescope.lofar.beam.
fwhm
(lambda_, d, alpha1=1.3)[source]¶ The nominal Full Width Half Maximum (FWHM) of a LOFAR Station beam.
Parameters:  lambda – wavelength in meters
 d – station diameter.
 alpha1 – depends on the tapering intrinsic to the layout of the station, and any additional tapering which may be used to form the station beam. No electronic tapering is presently applied to LOFAR station beamforming. For a uniformly illuminated circular aperture, alpha1 takes the value of 1.02, and the value increases with tapering (Napier 1999).
Returns: the nominal Full Width Half Maximum (FWHM)
functions for calculating theoretical noise levels of LOFAR equipment.
For more information about the math used here read the sensitivity of the LOFAR array page.
To check the values calculated here one can use this LOFAR image noise calculator.

tkp.telescope.lofar.noise.
Aeff_dipole
(freq_eff, distance=None)[source]¶ The effective area of each dipole in the array is determined by its distance to the nearest dipole (d) within the full array.
Parameters:  freq_eff – Frequency
 distance – Distance to nearest dipole, only required for LBA.

tkp.telescope.lofar.noise.
noise_level
(freq_eff, bandwidth, tau_time, antenna_set, Ncore, Nremote, Nintl)[source]¶ Returns the theoretical noise level (in Jy) given the supplied array antenna_set.
Parameters:  bandwidth – in Hz
 tau_time – in seconds
 inner – in case of LBA, inner or outer
 antenna_set – LBA_INNER, LBA_OUTER, LBA_SPARSE, LBA or HBA