sdelay

DESCRIPTION

"sdelay" carries out a fringe search of correlated data (K5's cout format).

SYNOPSIS

sdelay      --- interactive operation
       sdelay will display candidate directories that contain "cout" format files.
   or
sdelay cout_file      --- non-interactive operation
       where cout_file is K5 software correlator output file
   or
sdelay [PP] [options]     --- interactive operation
       where PP : to make each PP output
   or
sdelay cout_file [PP] [options]      --- non-interactive operation
   or
sdelay [options]
   or
sdelay --version      --- show program version
   or
sdelay HELP|?|--help      --- show how to execute
   or
sdelay env      --- show environmental variables used in this program

OPTIONS
-v verbose
-cout coutfile set correlator(cor or fx_cor) output file name
-sdir coutdir set search start cout file directory to read
-cdir coutdir set cout file directory to process all
The differnce between -sdir and -cdir is as follows,
-sdir : set search start directory
-cdir : set cout directory to process all files
-ppout make output file of each PP data by every channel besides normal sdelay out file.
-nosingle force output to multiple files (default: all results are output in a single file)
-odir outdir sdelay output directory
-pgplot device set PGPLOT device (/NULL for suppression)
-ps set graphics out to PostScript (pgplot.ps or gnuplot.ps)
-2nd t2dot search up to 2nd order rate and set search range from -t2dot to +t2dot (default for t2dot is 1.0e-13 s/s^2)
-fringe plot fringe phase and amplitude
-pcal plot PCAL phase and amplitude
-vspeplot plot video cross spectrum and output spectrum data to "vspeout.txt" file
-no3d suppress plot of coarse search function
-noplot suppress all graphics plots\\
-integ tinteg force integration time to tinteg sec. (default is all available period)
-vanvleck make Van Vleck correction using r=sin(r_c*pi/2) where r is true correlation coefficient, and r_c is coefficient for 1-bit samplig data. This option will be neglected in case of multi-bit AD data.
-out ofile output 2D array data to a text file besides normal sdelay out
-classic classic axis style (no tic marks) for 3D plots
-tzoom tzoom delay axis zoom-up factor tzoom >= 1.0)
-tshift tshift delay axis shift value when tzoom is set (sec) (set new center value for delay axis).
-bpf flow:fhigh[:fact][,flow:fhigh[:fact][,flow:fhigh[:fact][,.....]]]
set BPF by lower and higher cut-off frequencies (upto 20 sets)
flow : lower cut-off frequency in a baseband (MHz)
fhigh : higher cut-off frequency in a baseband (MHz)
fact : amplitude factor (0.0-1.0), default is 1.0
-bpf2 fc:bw[:fact][,fc:[bw][:fact][,fc:[bw]:fact][,.....]]]
set BPF parameters by center frequency and bandwidth (upto 20 sets)
fc : center frequency in a baseband (MHz)
bw : pass bandwidth (MHz). It can be omitted for 2nd and later BPF if it is the same bandwidth with the 1st one.
fact : amplitude factor (0.0--1.0), default is 1.0
-fres fres set frequency resolution (MHz) (deflt is automatic)
-delpcal ch#:fs[:fi][,ch#:fs[:fi][,....]]]}
set PCAL signal frequencies to reject by channel
  ch# -- channel number (starting from 1)
  fs -- lowest frequency of PCAL signals in baseband (MHz)
  fi -- interval of PCAL signals (MHz)
frequencies of PCAL signals removed are fs, fs+fi, fs+2fi, fs+3fi, ...
when fi is omitted, only fs is removed
bandwidth of rejection filter is four-times the resolution of FFT (# of FFT is double # of lags at correlation processing). this can be changed by option `-pcalbw' below
  or
-delpcal delpcal_file set file name which describes PCAL signal rejection information
-pcalbw bwmhz set bandwidth of PCAL rejection filter (MHz)
default bandwidth is four-times the resolution of FFT (# of FFT is double # of lags at correlation processing)
-line[mode] set line spectrum mode. 1st FFT size is set as same as lag size
-hanning apply Hanning filter on correlation function
-lag[size] lag set new lag size to reduce lag size (should be a power of 2). Note: This option cannot be used with `-hanning' and/or `-vanvleck' options
-sub[panels] 1|4|9|16
set # of subpanels in a main panel compulsory (default is automatic) (Note: only PGPLOT support this parameter)
-nodel[ay_correction]
no delay correction in integrated video spectrum
-obs[out] display observed results and total fringe phase (default is no display)
-so[ffset] start_offset set start time offset (float sec) (default is 0.0)
-fmt8 mode set Format 8 COUT file (cross spectrum) processing mode
   1: double the # of frequency component like FMT 7 (default)
   0: no double the # of frequency compnents
-w_mode mode set frequency elements doubler mode for checking
   1: using FFT method
   2: using linear interpolation
   3: using vector interpolation (default)
-nodouble[fmt8] same as "-fmt8 0"
-no_w same as "-fmt8 0"
-no_rev[erse] non-reverse frequency axis for FMT8
-sdelo[ut] sdelfile set sdelay out file name (default is "sdelayout.txt")
-snr2 display SNR2 using noise level computed from a search function
-ch chn set CH# to display (default: display all channels)
-zmax zmax set maximum value of fringe amplitude in a search-function plot compulsory (default is auto)
-noin[fo] suppress information of file name and processing date in a search-function plot
-notitle | -nohead suppress header part in a search-function plot

ENVIRONMENT VARIABLES

K5SDELAY default directory for correlation data out
PGDISP default PGPLOT display device

Updated on August 6, 2020