General Utilities¶

gatherDebugging.py

Description:	Script to gather information about the Pytho/numpy/LSL install to help with troubleshooting.
Usage:	gatherDebugging.py
Options:	None

astroevents.py

Description:	Application to display rise, transit, and set times for various astronomical sources from LWA-1 for the current date.
Usage:	astroevents.py
Options:	None

astrostatus.py

Description:

Application to calculate real-time ephemeris for a LWA site.

Usage:

astrostatus.py [options]

Options:

`-h, --help`	show this help message and exit
`-s SITE, --site=SITE`
	site name (default LWA-1)

driftcurve.py

Description:

Generate a drift curve for a dipole at LWA-1 observing at a given frequency in MHz.

Usage:

driftcurve.py [OPTIONS]

Options:

`-h, --help`	Display this help information
`-f, --freq`	Frequency of the observations in MHz (default = 74 MHz)
`-p, --polarization`
	Polarization of the observations (NS or EW; default = EW)
`-l, --lf-map`	Use LF map instead of GSM
`-t, --time-step`
	Time step of simulations in minutes (default = 10)
`-x, --do-plot`	Plot the driftcurve data
`-v, --verbose`	Run driftcurve in vebose mode

lwa_cat_view.py

Description:

Simple LWDA astronomical source catalogue display application.

Usage:

lwa_cat_view.py [options]

Options:

`-h, --help`	show this help message and exit
`-s SITE, --site=SITE`
	site name (default LWDA)
`-p PERIOD, --period=PERIOD`
	update period in seconds (default 5)

plotAntenna.py

Description:

Plot the relative dipole response for both polarizations of an isolated LWA-1 antenna at a particular frequency.

Usage:

plotAntenna.py [OPTIONS]

Options:

`-h, --help`	Display this help information
`-f, --freq`	Frequency of the observations in MHz (default = 74 MHz)
`-v, --verbose`	Run plotAntenna in vebose mode

plotStands.py

Description:

Plot the x, y, and z locations of stands at LWA-1. Also, mark and label particular stands, if requested.

Usage:

plotStands.py [OPTIONS] [stand1 [stand2 [...]]]

Options:

`-h, --help`	Display this help information
`-l, --label`	Label the stands with their ID numbers (default = No)
`-v, --verbose`	Run plotStands in vebose mode

plotUVCoverage.py

Description:	Randomly select 20 antennae from LWA-1 and plot the uv-plane coverage for a zenith snapshot and the expected beam. Alternatively, select some FRACTION of the stands with installed FEEs to use or use the specified list of stands.
Usage:	plotUVCoverage.py [FRACTION \| STAND LIST]
Options:	None

lsDRSU.py

Description:

Simple ls type script for DRSUs.

Usage:

lsDRSU.py [OPTIONS] md_device [pattern]

Options:

`-h, --help`	Display this help information
`-l`	Long listing format of size, mtime, and name
`-t`	Sort by modification time
`-1`	List one file per line

cpDRSU.py

Description:

Simple cp type script for DRSUs.

Usage:

cpDRSU.py md_device drsu_file destination

Options:

`-h, --help`	Display this help information
`-v, --verbose`	Be verbose

scpDRSU.py

Description:

Simple scp type script for DRSUs.

Usage:

scpDRSU.py md_device drsu_file user@host:destination

Options:

`-h, --help`	Display this help information
`-v, --verbose`	Be verbose

md5sum.py

Description:

Simple md5sum type script for DRSUs.

Usage:

md5sum.py [OPTIONS] md_device file1 [file2 [...]]

Options:

-h, --help

Display this help information

Data Reading and Writing¶

splitTBN.py

Description:

Split a TBN file containing multiple seconds into several files

Usage:

splitTBN.py [options] file

Options:

`-h, --help`	Display this help information
`-c, --count`	Number of seconds to keep
`-o, --offset`	Number of seconds to skip before splitting
`-d, --date`	Label the split files with a date rather than a squence number

Note

This script does not use a lsl.reader.buffer buffer to try to re-order or verify all packets and simply splits files based on size.

splitDRX.py

Description:

Split a DRX file containing multiple seconds into several files

Usage:

splitDRX.py [options] file

Options:

`-h, --help`	Display this help information
`-c, --count`	Number of seconds to keep
`-o, --offset`	Number of seconds to skip before splitting
`-d, --date`	Label the split files with a date rather than a squence number

readTBW.py

Description:	Example script for reading in TBW data and writing it to a TSFITS file.
Usage:	readTBW.py file
Options:	None

readTBN.py

Description:	Example script for reading in TBN data and writing it to a TSFITS file.
Usage:	readTBN.py file
Options:	None

readTBN_buffered.py

Description:	Example script for reading in TBW data and writing it to a TSFITS file. This version differs from the regular readTBN script in that it uses a frame buffer to reorder out-of-order packets and dropped frames.
Usage:	readTBN_buffered.py file
Options:	None

readDRX.py

Description:	Example script for reading in DRX data and writing it to a SD-FITS file.
Usage:	readDRX.py file
Options:	None

plotMapper.py

Description:	Read and plot the NOSTA_MAPPER table in a FITS IDI file writen by `lsl.writer.fitsidi` if it exists.
Usage:	plotMapper.py file
Options:	None

Data Analysis¶

tbwSpectra.py

Description:

Given a TBW file, plot the time averaged spectra for each digitizer input.

Usage:

tbwSpectra.py [OPTIONS] file

Options:

`-h, --help`	Display this help information
`-m, --metadata`	Name of SSMIF file to use for mappings
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-g, --gain-correct`
	Correct signals for the cable losses
`-s, --stack`	Stack spectra in groups of 6 (if ‘-g’ is enabled only)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra imag

Warning

tbwSpectra.py currently assumed that the system it is running on has enough memory to read in a full TBW capture. Due to data representation and processing overheads this amounts to about 16 GB.

tbnSpectra.py

Description:

Given a TBN file, plot the time averaged spectra for each digitizer input.

Usage:

tbnSpectra.py [OPTIONS] file

Options:

`-h, --help`	Display this help information
`-m, --metadata`	Name of SSMIF file to use for mappings
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-s, --skip`	Skip the specified number of seconds at the beginning of the file (default = 0)
`-a, --average`	Number of seconds of data to average for spectra (default = 10)
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra image

drxSpectra.py

Description:

Given a DRX file, plot the time averaged spectra for each beam output.

Usage:

drxSpectra.py [OPTIONS] file

Options:

`-h, --help`	Display this help information
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-s, --skip`	Skip the specified number of seconds at the beginning of the file (default = 0)
`-a, --average`	Number of seconds of data to average for spectra (default = 10)
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra image

correlateTBW.py

Description:

Cross-correlate data in a TBW file

Usage:

correlateTBW.py [OPTIONS] file

Options:

`-h, --help`	Display this help information
`-f, --fft-length`
	Set FFT length (default = 512)
`-s, --samples`	Number of average visibilities to generate (default = 10)
`-q, --quiet`	Run correlateTBW in silent mode

correlateTBN.py

Description:

Example script that reads in TBN data and runs a cross-correlation on it. The results are saved in the Miriad UV format.

Usage:

correlateTBN.py [OPTIONS] file

Options:

`-h, --help`	Display this help information
`-c, --central-freq`
	Central frequency of the observations in MHz
`-f, --fft-length`
	Set FFT length (default = 512)
`-t, --avg-time`	Window to average visibilities in time (seconds; default = 6 s)
`-s, --samples`	Number of average visibilities to generate (default = 10)
`-q, --quiet`	Run correlateTBN in silent mode

possm.py

Description:	Script that takes a FITS IDI file and mimics the AIPS task POSSM by plotting average cross-power spectra for all baselines in the FITS IDI file.
Usage:	possm.py file
Options:	None

imageIDI.py

Description:	Script that takes a FITS IDI file and images the data.
Usage:	imageIDI.py file
Options:	None

Post-IOC Compatible Scripts¶

The scripts listed below are compatible with post-IOC observing conditions and use the meta-data tarballs provided with each observation to set all relevant parameters (frequency, stand mappings, etc.) These scripts can be found in the scripts/IOC directory included with LSL 0.5.

See also

MCS0030 for a description of the post-IOC observing procedure and the contents of the meta-data tarball.

plotStands.py

Description:

Plot the x, y, and z locations of stands at LWA-1. Also, mark and label particular stands, if requested.

Usage:

plotStands.py [OPTIONS] metaData [stand1 [stand2 [...]]]

Options:

`-h, --help`	Display this help information
`-l, --label`	Label the stands with their ID numbers (default = No)
`-v, --verbose`	Run plotStands in vebose mode

plotUVCoverage.py

Description:

Randomly select 20 antennae from LWA-1 and plot the uv-plane coverage for a zenith snapshot and the expected beam. Alternatively, select some FRACTION of the stands with installed FEEs to use or use the specified list of stands.

Usage:

plotUVCoverage.py [OPTIONS] metaData

Options:

`-h, --help`	Display this help information
`-f, --frequency`
	Frequency in MHz to compute the uv coverage (default 50 MHz)

readTBN_buffered.py

Description:	Example script for reading in TBW data and writing it to a TSFITS file. This version differs from the regular readTBN script in that it uses a frame buffer to reorder out-of-order packets and dropped frames.
Usage:	readTBN_buffered.py metaData data
Options:	None

tbwSpectra.py

Description:

Given a TBW file, plot the time averaged spectra for each digitizer input.

Usage:

tbwSpectra.py [OPTIONS] metaData data

Options:

`-h, --help`	Display this help information
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-g, --gain-correct`
	Correct signals for the cable losses
`-s, --stack`	Stack spectra in groups of 6 (if ‘-g’ is enabled only)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra imag

Warning

tbwSpectra.py currently assumed that the system it is running on has enough memory to read in a full TBW capture. Due to data representation and processing overheads this amounts to about 16 GB.

tbnSpectra.py

Description:

Given a TBN file, plot the time averaged spectra for each digitizer input.

Usage:

tbnSpectra.py [OPTIONS] metaData data

Options:

`-h, --help`	Display this help information
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-s, --skip`	Skip the specified number of seconds at the beginning of the file (default = 0)
`-a, --average`	Number of seconds of data to average for spectra (default = 10)
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra image

drxSpectra.py

Description:

Given a DRX file, plot the time averaged spectra for each beam output.

Usage:

drxSpectra.py [OPTIONS] metaData data

Options:

`-h, --help`	Display this help information
`-t, --bartlett`	Apply a Bartlett window to the data
`-b, --blackman`	Apply a Blackman window to the data
`-n, --hanning`	Apply a Hanning window to the data
`-s, --skip`	Skip the specified number of seconds at the beginning of the file (default = 0)
`-a, --average`	Number of seconds of data to average for spectra (default = 10)
`-q, --quiet`	Run tbwSpectra in silent mode
`-l, --fft-length`
	Set FFT length (default = 4096)
`-d, --disable-chunks`
	Display plotting chunks in addition to the global average
`-o, --output`	Output file name for spectra image

correlateTBW.py

Description:

Cross-correlate data in a TBW file

Usage:

correlateTBW.py [OPTIONS] metaData data

Options:

`-h, --help`	Display this help information
`-f, --fft-length`
	Set FFT length (default = 512)
`-s, --samples`	Number of average visibilities to generate (default = 10)
`-q, --quiet`	Run correlateTBW in silent mode

correlateTBN.py

Description:

Example script that reads in TBN data and runs a cross-correlation on it. The results are saved in the Miriad UV format.

Usage:

correlateTBN.py [OPTIONS] metaData data

Options:

`-h, --help`	Display this help information
`-f, --fft-length`
	Set FFT length (default = 512)
`-t, --avg-time`	Window to average visibilities in time (seconds; default = 6 s)
`-s, --samples`	Number of average visibilities to generate (default = 10)
`-q, --quiet`	Run correlateTBN in silent mode

splitSession.py

Description:	Given a MCS metadata tarball and a session DRX recording, split the session recording into the individual observations.
Usage:	splitSession.py metaData data
Options:	None

General Utilities¶

Data Reading and Writing¶

Data Analysis¶

Post-IOC Compatible Scripts¶

Table Of Contents

Previous topic

Next topic

This Page

Navigation

General Utilities¶

Data Reading and Writing¶

Data Analysis¶

Post-IOC Compatible Scripts¶

Table Of Contents

Previous topic

Next topic

This Page

Quick search

Navigation