Pipeline scripts for processing pulsar and FRB dynamic spectra using modules defined in psrdynspec.
All scripts import psrdynspec and its dependencies.
For every script basename, there exists a config file (.cfg extension under config folder) and an executable script (.py extension under exec folder). A .cfg file specifies inputs that are passed on to its corresponding .py script during execution
Each .py script also reports run times on the terminal at the end of execution. Owing to potentially long run times, I recommend users to execute programs within a screen/tmux session.
bandpass.py: Compute median bandpass shape based on a chunk of PSRFITS or filterbank data.grab_ds_fil.py: Plot smoothed, RFI-masked dynamic spectrum of a chunk of filterbank data.grab_ds_psrfits.py: Plot smoothed, RFI-masked dynamic spectrum of a chunk of PSRFITS data.
Program run syntax:
python <path to executable file> -i <path to config file of inputs>
The -i flag specifies the input configuration file to be read by the executable file.
Example call:
python exec/bandpass.py -i config/bandpass.cfg
plot_spcands_fil.py: Plot dynamic spectra of single pulse candidates identified in filterbank data.plot_spcands_psrfits.py: Plot dynamic spectra of single pulse candidates identified in PSRFITS data.
Program run syntax:
mpirun -n <nproc> python <path to executable file> -i <path to config file of inputs>
Default execution assumes operation on a single processor. If multiple processors are called, a parent-child MPI framework is invoked. Within this model, one processor is designated as a parent processor, whereas the remaining processors are classified as child processors. The parent distributes tasks evenly and collates outputs from the child processors.
Example call:
mpirun -n 4 python exec/plot_spcands_fil.py -i config/plot_spcands_fil.cfg
The DEV folder contains code under development. Use of these scripts for data processing is highly discouraged.
Please submit an issue to voice any problems or requests. Improvements to the code are always welcome.