This program displays data using a PGPLOT device. The following file types are supported:
- DAS
.specfilterbank format - SIGPROC
.filfilterbank format (including the headerless version, provided a.fhdconfiguration file is present in the same directory) - SIGPROC
.timtime series format - PRESTO
.dattime series format
For time series data, plots are scaled by the absolute minimum and
maximum values in the data. If the baseline is non-flat, the
--no-abs-scale option may need to be given for proper
viewing (see below).
Usage:
yapp_viewdata [options] data-file
The options are:
-hor--help: Display this usage information-sor--skip time: Length of data to be skipped, in seconds (default is 0 s).-por--proc time: Length of data to be processed, in seconds (default is all data).-nor--nsamp samples: Number of time samples read in one block (default is 4096 samples).-cor--clip-level level: Number of sigmas above threshold; will clip anything above this level.-aor--no-abs-scale: Use relative scale for plotting per block.-tor--period period: Period of the pulsar in ms.-ror--phase phase: Phase of the first pulse with respect to the first sample.-mor--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'
-ior--invert: Invert background and foreground colours in plots (default is white on black).-eor--non-interactive: Run in non-interactive mode.-vor--version: Display the version.
Example:
This run displays the contents of the SIGPROC filterbank file
data.fil, with 8192 time samples per plot, and using the
'copper' colour map.
yapp_viewdata -n 8192 -m copper data.fil
The following displays the contents of the PRESTO dedispersed time
series file data.dat in the /data
directory.
yapp_viewmetadata /data/data.dat