CELEBI is an automated data processing pipeline for producing sub-arcsecond precision localisations and high-time resolution polarimetric measurements of fast radio bursts (FRBs) from voltages obtained with the Australian Square Kilometre Array Pathfinder (ASKAP).
CELEBI operates on the VCRAFT data format, and is designed to be run on a supercomputer. Once the dependencies have been installed, you should set up a config file based on the template for the data you are processing, create a work directory for processing to be performed in, and then run main.nf:
nextflow /path/to/CELEBI/pipelines/main.nf -c FRBXXXXX.config -w work/FRBXXXXX > FRBXXXXX.outIt is recommended that you do this from a separate processing directory as shown, and make use of the -with-report and -w Nextflow configuration options.
At the moment, the --calibrate flag and --noflag flag ate non-optional, despite what you'll read below, so these should be added too.
Running CELEBI without any additional flags will run everything up until completion of correlation. To perform flux calibration, imaging, and localisation, add --calibrate. To perform polarisation calibration and beamforming after this, add --beamform. Both of these flags can be provided together to run the entire pipeline in one go.
You can omit the FRB and polcal workflows from running with --nofrb and --nopolcal respectively. If the polcal is omited, the beamforming will substitute zeros in its polarisation calibration solutions.
RFI subtraction can be skipped with --skiprfi.
Visibility flagging can be skipped with --noflag. You can provide custom AIPS flag files with --fieldflagfile, --polflagfile, and --fluxflagfile. These can be provided alongside using automatic flagging.