mwa_search modules

data_load

Loads all the data required by mwa_search from the data directory.

dispersion_tools

mwa_search.dispersion_tools.dd_plan(centrefreq, bandwidth, nfreqchan, timeres, lowDM, highDM, min_DM_step=0.02, max_DM_step=500.0, max_dms_per_job=5000)[source]

Work out the dedisperion plan

Parameters:
centrefreq: float

The center frequency of the observation in MHz

bandwidth: float

The bandwidth of the observation in MHz

nfreqchan: int

The number of frequency channels

timeres: float

The time resolution of the observation in ms

lowDM: float

The lowest dispersion measure

highDM: float

The highest dispersion measure

min_DM_step: float

Will overwrite the minimum DM step with this value

max_dms_per_job: int

If Nsteps is greater than this value split it into multiple lines

Returns:
DD_plan_array: list list

dedispersion plan format: [[low_DM, high_DM, DM_step, nDM_step, timeres, downsample, nsub ]]

grid_tools

mwa_search.grid_tools.get_grid(ra, dec, grid_sep, loop, grid_type='hex', verbose=True)[source]

ra: Right Acension in radians dec: Declination in radians grid_sep: seperation between grid pointings in radians loop: number of pointing loops grid_type: Possible grid types from [‘hex’, ‘cross’, ‘squaire’]

return [rads, decds] RAs and Decs in degrees

obs_tools

mwa_search.obs_tools.calc_ta_fwhm(freq, array_phase='P2C')[source]

Calculates the approximate FWHM of the tied array beam in degrees.

Parameters:
freq: float

Frequency in MHz

array_phase: string

OPTIONAL - The different array phase (from P1, P2C, P2E) to work out the maximum baseline length. Default = ‘P2C’

Returns:
fwhm: float

FWHM in degrees

mwa_search.obs_tools.check_data(obsid, beg=None, dur=None, base_dir=None)[source]

Checks to see if all of the recombined files exist on disk

Parameters:
obsid: int

The observation ID to check

beg: int

OPTIONAL - The beginning time of the files to check. If none, will use entire obs. Default: None

dur: int

OPTIONAL - The duration in seconds to check since the beginning time. If none, will use entire obs. Default: None

base_dir: string

OPTIONAL - The base directory to use. If none, will load from config. Default: None

Returns:
check: boolean

True - all files are on disk. False - not all files are on disk

mwa_search.obs_tools.getTargetAZZA(ra, dec, time, lat=-26.7033, lon=116.671, height=377.827)[source]

Function to get the target position in alt/az at a given EarthLocation and Time.

Default lat,lon,height is the centre of MWA.

Parameters:
ra - target right ascension in astropy-readable format
dec - target declination in astropy-readable format
time - time of observation in UTC (i.e. a string on form: yyyy-mm-dd hh:mm:ss.ssss)
lat - observatory latitude in degrees
lon - observatory longitude in degrees
Returns:
a list containing four elements in the following order:

list[0] = target azimuth in radians list[1] = target zenith angle in radians list[2] = target azimuth in degrees list[3] = target zenith angle in degrees

mwa_search.obs_tools.getTargetradec(az, za, time, lst, lat=-26.7033, lon=116.671, height=377.827)[source]

Function to get the target position in ra dec at a given EarthLocation and Time.

Default lat,lon,height is the centre of MWA.

Parameters:
az - target aximuth in radians
za - target zenith in radians
time - time of observation in UTC (i.e. a string on form: yyyy-mm-dd hh:mm:ss.ssss)
lat - observatory latitude in degrees
lon - observatory longitude in degrees
Returns:
a list containing four elements in the following order:

list[0] = target ra in degrees list[1] = target dec in degrees