cor_new |
---|
DESCRIPTION |
---|
"cor_new" is an XF-type software correlator dedicated to 1-bit AD data supporting a variety of data formats, such as Mark5B, VDIF, ADS, OCTAD besides K5/VSSP, and carries out cross correlation processing using an apriori file. Correlated data are output to a file with a "cout" format. Auto-correlation or cross correlation with zero apriori value are also available.
SYNOPSIS |
---|
cor_new afile [options]
afile | a-priori file name created by "apri_calc" |
OPTIONS | |
--version | show program version |
--help | show how to execute |
-integ integration_time | set integration period (sec). Default is a scheduled scan period. |
-coffset clock_offset | set clock offset (sec) applied for fringe search purpose. Positive value menas Y clock tic earlier than X clock tic. Default is 0.0 |
-crate clock_rate | set clock rate (s/s) difference between X and Y station clock applied for fringe search purpose. Default is 0.0 |
-soffset start_offset | set start time offset (integer sec). Default is 0. |
-t1pp t1pp | set unit integration period (parameter period) (sec) for correlation processing. Default is BT1PP in "cor_head.h" (usually 1) |
-pp_nosync | turns off the synchronization mode of PP (parameter period) (dfault is that PP synchronize to second tic) |
-lag lagsize | set the size of delay lag window. lagsize can be 16, 32, 64, 128, 256, 512, .. Default is DELAYSIZE in cor_head.h |
-pmode pmode | set plot mode. 0 : XWINDOW (env PGDISP can change PGPLOT display device) and PostScript file (pgplot.ps or gnuplot.ps) out (dfault) 1 : PostScript file (pgplot.ps or gnuplot.ps) out only 2 : XWINDOW only -1 : No graphic output |
-comment "any_comment" | |
set comment appeared in a correlation function plot when pmode=0,1,2 | |
-nopcal | turn off the function of the phase calibration (PCAL) signal detection |
-pchx1 ch1 | define pickup chanel# as CH# 1 of X data (Ver.2018-12-17 or later) |
-pchx2 ch2 | define pickup chanel# as CH# 2 of X data |
......... | |
-pchx16 ch16 | define pickup chanel# as CH# 16 of X data |
-pchy1 ch1 | define pickup chanel# as CH# 1 of Y data (Ver.2018-12-17 or later) |
-pchy2 ch2 | define pickup chanel# as CH# 2 of Y data |
......... | |
-pchy16 ch16 | define pickup chanel# as CH# 16 of Y data |
-ch1 ch1Y | define Y channel for X CH# 1 (default 1). |
-ch2 ch2Y | define Y channel for X CH# 2 (default 2). |
......... | |
-ch16 ch16Y | define Y channel for X CH# 16 (default 16). |
-orule naming_rule | set naming rule of output file name 0 : use program default (cout.txt) 1 : coutNNNNtxt (deflt) where NNNN is 4 digit serial number 2 : coutEXP_CODE/coutYYDDDNNNNXYG.txt where EXP_CODE -- experiment code3 : coutYYDDDNNNNXYG.txt where YY -- 2 digit year(default is COUT_NAMING_RULE in cor_head.h) |
-odir outdir | set output file directory. Default is COUTDFLT in cor_head.h |
-rfoffset rf_offset | set RF frequency difference between Y and X (RFy-RFx)(Hz) |
-cout cout_file | set output file name compulsory. If this parameter is set, naming rule and out directory are ignored. |
-frstep frstep | set fringe phase calculation step in samples 0: automatic calc 1: every 1 sample 8: every 8 sample N: every N sample. (Note: N can be any number, but 1000/N must be integer) default is FRSTEP_FX_COR (in cor_head.h) |
-frauto | set frstep=0 (automatic calculation mode) |
-fall pcalf | set PCAL frequency of all channels compulsory (kHz) |
-f1 pcalf1 | set CH1 PCAL frequency compulsory(kHz) |
-f2 pcalf2 | set CH2 PCAL frequency compulsory(kHz)(kHz) |
................ | |
-f16 pcalf16 | set CH16 PCAL frequency compulsory(kHz)(kHz) |
===== t1pp allowed for less than 1 sec is as follows ====
(this is due to the algorythm)
t1pp | |||||||
fsampl | 0.01 | 0.02 | 0.04 | 0.05 | 0.1 | 0.2 | 0.5 |
40kHz | X | OK | OK | X | OK | OK | OK |
100kHz | X | X | OK | X | X | OK | X |
200kHz | X | OK | OK | X | OK | OK | OK |
500kHz | X | X | OK | X | X | OK | X |
1MHz | X | OK | OK | X | OK | OK | OK |
2MHz | OK | OK | OK | OK | OK | OK | OK |
4MHz | OK | OK | OK | OK | OK | OK | OK |
8MHz | OK | OK | OK | OK | OK | OK | OK |
16MHz | OK | OK | OK | OK | OK | OK | OK |
32MHz | OK | OK | OK | OK | OK | OK | OK |
cor_new afile [sekibun [soffset [coffset [crate [t1pp [smode [pp_mode [lag_size [tzoom [pmode [comment]]]]]]]]]]]
afile | a-priori file name created by "apri_calc" |
sekibun | integration period (sec). Default is a scheduled scan period. |
soffset | start time offset (integer sec). Default is 0. |
coffset | clock offset (sec) |
crate | clock rate offset (s/s) |
t1pp | unit integration period (parameter period) (sec) |
smode | search mode 0: Wide 1: Mid 2:Narrow (default 2) (no more use) |
pp_mode | PP synchronization mode 0: synchronized to second tic (default) 1: not synchronized to second tic |
lag_size | lag window size. 16,32,64,128,256,512,.. 0 means lag_size set to DELAYSIZE in "cor_head.h" |
tzoom | time axis zoom ratio in graphics (int) 0 : full scale (default) as same as 1 -VE : Max position is automatically centered |
pmode | plot device selection 0: XWINDOW (env PGDISP can change PGPLOT display device) and PostScript file (pgplot.ps or gnuplot.ps) out (default) 1: PostScript file (pgplot.ps or gnuplot.ps) out only 2: XWINDOW only -1: No graphic output |
comment | comment appeared in a correlation function plot |
[Monitoring Environmental Variables]
cor_new env
check environmental variables used in "cor_new"
K5APRIDIR -- default directory for apriori file
K5COUT -- default directory for correlation data out
PGDISP -- PGPLOT display device name when plot