wiki:Pulsar

Pulsar Tools for LWA-1

Overview and Requirements

The pulsar tools build off the LSL 0.6.x/1.0.x framework for working with LWA data and also depends on the following Python modules:

No installation (e.g., python setup.py install) is required to use the software. Simply run make to build the _psr.so and _helper.so modules and then use the scripts in the Pulsar directory.

Obtaining

The easiest way to obtain the latest version of the pulsar tools is via subversion export/checkout:

svn checkout http://fornax.phys.unm.edu/lwa/subversion/trunk/Pulsar

Contents

writePsrfits2.py

Given a DRX file, create a PSRFITS file of the data.

writePsrfits2.py [OPTIONS] drx_filename

writePsrfits2D.py

Given a DRX file, coherently dedisperse the data at the specified DM and create a PSRFITS file of the data.

writePsrfits2D.py [OPTIONS] DM drx_filename

writePsrfits2FromDRSpec.py

Given a DR spectrometer file in either XX/YY, IV, or IQUV mode, create a PSRFITS file of the data.

writePsrfits2FromDRSpec.py [OPTIONS] drspec_filename

writePsrfits2FromHDF5.py

Given an HDF5 created by hdfWaterfall.py or drspec2hdf.py, create a PSRFITS file of the data.

writePsrfits2FromHDF5.py [OPTIONS] hdf5_filename

writePsrfits2Multi.py

Experimental script to that takes in a collection of DRX files observed at the same time and processes them such that they are aligned in time. This yields PSRFITS files that can be combined with the 'combine_lwa' script across multiple beams.

writePsrfits2DMulti.py

Experimental script to that takes in a collection of DRX files observed at the same time and processes them such that they are both aligned in time and coherently dedispersed. This yields PSRFITS files that can be combined with the 'combine_lwa' script across multiple beams.

writeHDF5FromPsrfits.py

Given a PSRFITS file created by the writePsrfit2 family of converters, build an HDF5 file that is compatiable with the tools in Commissioning/DRX/HDF5.

updatePsrfitsMask.py

Use spectral kurtosis to update the weight mask in a PSRFITS file to flag RFI. The script also takes in a list of frequencies/frequency ranges that can be used to update the weight mask.

plotSinglePulse.py

Graphical interface for working with .singlepulse search results from PRESTO.

psr.c

Compiled Python/NumPy extension used by the scripts to speed up processing.

helper.c

Compiled Python/NumPy extension used by the script to speed up display.

Makefile

Makefile for the psr.c module.

data.py

External file from Commissioning/DRX/HDF5 used by writeHDF5FromPsrfits.py for building the HDF5 files.

drx2drxi.py

Script to take a standard DRX file and convert it to two polarization interlaced DRX files, one for each tuning. The interlaced DRX format is compatiable with the dspsr suite.