This program displays data using a PGPLOT device. 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
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:
-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).-n
or--nsamp samples
: Number of time samples read in one block (default is 4096 samples).-c
or--clip-level level
: Number of sigmas above threshold; will clip anything above this level.-a
or--no-abs-scale
: Use relative scale for plotting per block.-t
or--period period
: Period of the pulsar in ms.-r
or--phase phase
: Phase of the first pulse with respect to the first sample.-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'
-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.
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