Folds filterbank and dedispersed time series data at the given period, and displays the folded profile in a PGPLOT window. The following file types are supported:

• DAS .spec filterbank format
• SIGPROC .fil filterbank format (including the headerless version, provided a .fhd configuration file is present in the same directory)
• SIGPROC .tim time series format
• PRESTO .dat time series format

This program creates an ASCII output file (with extension .ypr) of the folded profile for time series input, and no output file for filterbank input.

Usage:

• -h or --help: Display this usage information.
• -s or --skip time: Length of data to be skipped, in seconds (default is 0 s).
• -p or --proc time: Length of data to be processed, in seconds (default is all data).
• -t or --period period: Folding period in milliseconds.
• -w or --waterfall numpulses: Show a waterfall plot (pulse number versus phase) instead of a folded profile.
• -m or --colour-map name: Colour map for plotting. Supports some of the standard MATLAB colour maps, plus a few more. Valid colour map names are given below (default is 'jet').
  • 'autumn'
  • 'blue'
  • 'bone'
  • 'cool'
  • 'copper'
  • 'gray'
  • 'gray-inv'
  • 'hot'
  • 'hot-inv'
  • 'jet'
  • 'pink'
  • 'spring'
  • 'summer'
  • 'winter'
  • 'RdBu'
  • 'BuRd'
• -f or --file: Plot to file, instead of to screen.
• -i or --invert: Invert background and foreground colours in plots (default is white on black).
• -e or --non-interactive: Run in non-interactive mode.
• -v or --version: Display the version.

The flag -t (or --period) is a required argument.

Example:

Folds the data in data.tim with a period of 89.3 ms, in non-interactive mode, with the folded profile plot written to data.fold.ps, and the folded profile data written to the ASCII file data.ypr.