PulsarX

PulsarX is a toolset for pulsar searching, including RFI mitigation, dedispersion, folding, optimization and accelerate search (under development). Psrfits and filterbank are both supported.

Requirements:

To generate figures, python,matplotlib,numpy or PlotX should be installed.
To calculate GL and GB, sofa library (https://www.iausofa.org/2020_0721_C/sofa_c-20200721.tar.gz) should be installed.
To calculate YMW16 DM and distance, environment variable YMW16_DIR should be set.

Installation:

./bootstrap
./configure --prefix=/install_path LDFLAGS="-L/path_to_sofa" CPPFLAGS="-I/path_to_sofa"
make and make install

Programs

filtool
clean the filterbank file or psrfits file (--psrfits), and generate a new one, e.g.
filtool -v --filplanfilplan.json-f *.fil
dedisperse_all_fil
remove rfi and dedisperse the filterbank/psrfits (--psrfits) file, e.g.
dedisperse_all_fil -v --ddplan ddplan.txt -z zdot --format presto -f *.fil
psrfold_fil
fold and optimize the pulsar candidate, e.g.
psrfold_fil -v --template ~/software/PulsarX/include/template/meerkat_fold.template --candfile example.cands --plotx -n 64 -b 64 --clfd 2 -f *.fil

Docker:

docker pull ypmen/pulsarx

Citation

Please cite https://arxiv.org/abs/2309.02544, if you are using PulsarX.

Acknowledgement

Thanks for very helpful suggestions and bug reports from Ewan Barr, Colin Clark, Emma Carli, Shalini Sengupta, Vivek Venkatraman Krishnan, Miquel Colom i Bernadich, Prajwal Padmanabh and TRAPUM project.

kmjc/PulsarX