apri_calc |
---|
DESCRIPTION |
---|
Apri_calc calculates a priori values necessary for cross correlation processing. Both SKED and VEX format files are supported as a schedule file.
The analysis method of the $CODES block in the SKED file is improved at Ver.2019-12-21 and later. As a consequence, it is possible to create an appropriate a-priori file even if the correspondence of frequency and CH# is different for each station. The option '-uoca' is added to keep compatibility with previous versions.
SYNOPSIS |
---|
[Type 1]
apri_calc skdfile [options]
skdfile | schedule file name (either VEX or SKED format) if "-" is accompanied with skdfile like "-skdfile", it means monitor only the contents of schedule file. option "-monit" as for Ver.2016-10-12 and later, option "-monit" gives the same function. |
OPTIONS | |
-apedir apedir | set directory for apriori file out. default is the environment variable K5APRIOUT. If this environment variable is not defined, then "../corrapri" will be applied as a default. |
-baseid baseline_id | set baseline ID (A2 or A4) |
-coffset clock_offset | set clock offset (sec) of Y station to X station. 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. Default is 0.0 |
-cepoch epoch | set epoch of clock offset and clock rate epoch is a format of either YYYY/DDD-HH:MM:SS or YYYY/MM/DD-HH:MM:SS or YYYYDDDHHMMSS or 0 (0 means each PRT: Default is each PRT) |
-g group | set frequency group (1-4) for 4ch mode correspnding to a sampler host PC (default is 1) When data format is set to other than "K5/VSSP", default becomes 0 (all channels will be selected) |
-ch channel | set frequency channel for 1ch mode (default is 1) |
-start start_obs | set start scan# (default is the 1st scan#) |
-stop stop_obs | set stop scan# (default is the last scan#) |
-xdir xdir | set X data file directory (default is "./") |
-ydir ydir | set Y data file directory (default is "./") |
-ut1 ut1_c | set UT1-UTC (sec) |
-wobbx wobbx | set Wobb X (arcsec) |
-wobby wobby | set Wobb Y (arcsec) |
-type1 | -type2 | set K5 observation file naming rule -type1 : sidDDDNNNN.dat (default) -type2 : sidDDDHHMMSSG.dat |
-type naming_type | set K5 observation file naming rule 1 : Type 1 sidDDDNNNN.dat (default for SKED) -1 : Type -1 sidDDDNNNN.#ch.dat 2 : Type 2 sidDDDHHMMSSG.dat -2 : Type -2 sidDDDHHMMSSG.#ch.dat 3 : Type 3 expid_sidG_scanid_YYYYDDDHHMMSS.k5 4 : Unused 5 : Type 5 expid_scan#.stcode.k5a(-d) (default for VEX) 6 : Type 6 expid_sid_scanid.k5a(-d) Note for Ver.2018-12-14 and after: "G" or "k5" extension is omitted for non-VSSP format |
-typeX naming_type | set K5 obs file naming rurle for X station |
-typeY naming_type | set K5 obs file naming rurle for Y station |
-subnet | -nosubnet | subnet mode control. Default is subnet on (-subnet) |
-skey satellite_key | set satellite key(s) for "NOZOMI" mode. If there are keys more than one, use " " like -skey "NOZ HYB HEO" |
-xcoff x_clock_offset | set clock offset (sec) of X station to UTC. Positive value menas X clock tic earlier than UTC clock tic. Default is 0.0 |
-lsb | set sideband LSB compulsory in case of SKED file |
-shift time | shift start time of 1st scan to given time, where time is either YYYY/DDD-HH:MM:SS or YYYY/MM/DD-HH:MM:SS or YYYYDDDHHMMSS. |
-format format [sampling_cond|info_file] | |
set data format and sampling information of both station as the same format format: VDIF|MK5|M5B|OCTAD|ADS|VSSP (default is VSSP) sampling_cond: sampling information for M5B, OCTAD, ADS formats as follows. xM[Hz]nB[IT]mC[H] (any order), where x -- sampling frequency (MHz) n -- # of AD bits m -- # of channels info_file: information file for MK5 format generated by m5tok5 (Ver.2020-06-12 and later) | |
-formX format [sampling_cond|info_file] | |
set data format and sampling information for X station (default is VSSP) | |
-formY format [sampling_cond|info_file] | |
set data format and sampling information for Y station (default is VSSP) | |
==== following options are valid for Ver.2016-10-12 and later ==== | |
-source star_name | set extracting scans by a star name from a schedule file. |
-m[onit] | set monitor mode |
==== following options are valid for Ver.2017-09-05 and later ==== | |
-ext extension | set extension of data file name compulsorily |
-extX extension | set extension of X data file name compulsorily |
-extY extension | set extension of Y data file name compulsorily |
==== following options are valid for Ver.2017-10-18 and later ==== | |
-chx [ch1,ch2,...] | assign channel compulsory for X station instead of VEX description in case of non-VSSP format when parameters ch1,ch2,... omitted use 1 2 3 4 .... |
-chy [ch1,ch2,...] | assign channel compulsory for Y station instead of VEX description in case of non-VSSP format when parameters ch1,ch2,... omitted use 1 2 3 4 .... |
==== following options are valid for Ver.2019-05-23 and later ==== | |
-thread thread_num | set thread# for X and Y data (VDIF only) (starting from 0). Default is 1st thread# in data. |
-threadX thread_num | set thread# for X data (VDIF only) (starting from 0). Default is 1st thread# in data. |
-threadY thread_num | set thread# for X data (VDIF only) (starting from 0). Default is 1st thread# in data. |
==== following options are valid for Ver.2019-12-03 and later ==== | |
-thread MULTI|th1[,th2[,th3,....]] | |
set thread# for X and Y data (VDIF only) | |
MULTI : set default thread#s for each channel for single-ch/thread multi-thread VDIF data (that is 0,1,2,3,...) | |
th1[,th2[th3,...]]] : set thread #s for each channel. only th1 means use same thread# for all CHs | |
-threadX MULTI|th1[,th2[,th3,....]] | |
set thread# for X data (VDIF only) | |
-threadY MULTI|th1[,th2[,th3,....]] | |
set thread# for Y data (VDIF only) | |
==== following options are valid for Ver.2019-12-21 and later ==== | |
-uoca | use old method to analyze $CODE block of SKED file to keep compatibility with the version before 2019-12-21. ("uoca" stands for Use Old Code Analysis) |
-legacy | as same as option '-uoca'. |
[Type 2]
apri_calc skdfile [apedir [baseid coffset roffset frqgr nobs1 nobs2 xdir ydir ut1_c wobbx wobby [naming_type [subnet [xcoff [source]]]]]
skdfile | schedule file name (either VEX or SKED format) if "-" is accompanied with skdfile like "-skdfile", it means monitor only the contents of schedule file. option "-monit" as for Ver.2016-10-12 and later, option "-monit" gives the same function. |
apedir | a-priori file out directory; default is given by environmental variable K5APRIOUT. If this is not defined program default will be applied. |
if following parameters are omitted, they will be asked interactively | |
baseid | baseline ID (A2 or A4) |
coffset | clock offset (sec) |
roffset | clock rate offset (s/s) |
frqgr | frequency group# corresponding to observation PC (1-4) |
nobs1 | start scan# |
nobs2 | stop scan# (nobs1=0, nobs2=0 for all scans) |
xdir | data file directory for X station |
ydir | data file directory for Y station |
ut1_c | UT1-UTC (sec) |
wobbx | WobbX (arcsec) |
wobby | WobbX (arcsec) |
naming_type | K5 observation file naming rule 1 : Type 1 sidDDDNNNN.dat (default for SKED) -1 : Type -1 sidDDDNNNN.#ch.dat 2 : Type 2 sidDDDHHMMSSG.dat -2 : Type -2 sidDDDHHMMSSG.#ch.dat 3 : Type 3 expid_sidG_scanid_YYYYDDDHHMMSS.k5 4 : Unused 5 : Type 5 expid_scan#.stcode.k5a(-d) (default for VEX) 6 : Type 6 expid_sid_scanid.k5a(-d) Note for Ver.2018-12-14 and after: "G" or "k5" extension is omitted for non-VSSP format |
subnet | subnet mode control 0: no-subnet, 1: subnet on(dflt) |
xcoff | X clock offset to UTC (sec) |
==== following option is valid for Ver.2016-10-12 and later ==== | |
source | set extracting scans by a star name from a schedule file |
[Monitoring Environmental Variables]
apri_calc env
check environmental variables used in "apri_calc"
K5SKED -- default directory for schedule file
K5APRIDIR -- default directory for apriori file
K5NAMING -- default out file naming rule
[Note 1: Naming rule of observation data file]
XDDDNNNN.[#ch.]dat
where | ||
X | station ID (A1) | |
DDD | total day of 1st scan (3 digits) | |
NNNN | scan (obs) # (4 digits) | |
#ch | # of channels (1|4) (in case of type -1 or -I) |
sidDDDHHMMSSG.[#ch.]dat
where | ||
sid | station ID (A1 or A2) | |
DDD | scan start time: total day (3 digits) | |
HH | scan start time: hour (2 digits) | |
MM | scan start time: minute (2 digits) | |
SS | scan start time: second (2 digits) | |
G | frequency group ID (a|b|c|d) or null (null for non-VSSP format) | |
#ch | # of channels (in case of type -2 or -II) |
expid_sidG_scanid_YYYYDDDDHHMMSS.k5
where | ||
expid | experimental code | |
sid | station ID (2 characters (lower-case letters) | |
G | terminal (PC) ID (1|2|3|4) ‚Ü‚˝‚Ínull (set by freqg parameter) (null for non-VSSP format) | |
scanid | scan ID for VEX file ddd-hhmm for SKED file. When multiple scans are included in the same minute, a,b,c,d,... are added for the 2nd scan and later. | |
YYYYDDDHHMMSS | scan start time | |
.k5 | file descriptor for K5 format (null for non-VSSP format) |
expid_scan#.stcode.k5a(-d)
where | ||
expid | experimental code | |
scan# | scan # | |
stcode | station ID | |
k5 | descriptor for K5 format (null for non-VSSP format) | |
a-d | frequency group (or null) (null for non-VSSP format) |
[Note 2: Naming rule of created a-priori File]
apeDDDNNNNXYG.txt
where | ||
ape | fixed letters | |
DDD | total day of 1st scan | |
NNNN | scan (obs) # (4 digits) | |
XY | baseline ID (A2 or A4) | |
G | PC ID (a,b,c,d) or null corresponding to frequency group ID 1-4 or 0 |
apeDDDHHMMSSXYG.txt
where | ||
ape | fixed letters | |
DDD | scan start time: total day (3 digits) | |
HH | scan start time: hour (2 digits) | |
MM | scan start time: minute (2 digits) | |
SS | scan start time: second (2 digits) | |
XY | baseline ID (A2 or A4) | |
G | PC ID (a,b,c,d) or null corresponding to frequency group ID 1-4 or 0 |
ape_expid_sid1sid2_scanid_YYYYDDDDHHMMSS.txt
where | ||
ape | fixed letters | |
expid | experimental code | |
sid1 | station ID of X station (2 lower-case letters) | |
sid2 | station ID of Y station (2 lower-case letters) | |
scanid | scan ID for VEX file ddd-hhmm for SKED file. When multiple scans are included in the same minute, a,b,c,d,... are added for the 2nd scan and later. | |
YYYYDDDHHMMSS | scan start time |
[Note 3: Clock parameters and epoch]
Clock offset coffset is given as
Clock rate crate is given as
If clock rate is not 0, clock epock should be set as t1.
EXAMPLES (monitoring schedule) |
---|
[Ex.1 Checking environmental variables]
$ apri_calc env apri_calc (Ver. 2016-10-12) Enviroment variables K5SKED --- default directory for schedule file ( (null) ), program deflt is ( ./ ) K5APRIDIR --- default directory for apriori file ( (null) ), program deflt is ( ../corrapri/ ) K5NAMING --- default K5 file naming rule 1 | -1 | 2 | -2 | 3 | 5 ( (null) ), program deflt is ( 1 ) K5SATKEY --- default satellite keyword of 1ch obs ( (null) ), program deflt is ( HYB NOZ GEO )
[Ex.2 Checking a schedule file]
$ apri_calc -k10189.skd (or apri_calc k10189.skd -monit) apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) ============================================================= SkdMonit: *********** Schedule file monitor ********** SkdMonit: Schedule file = ./k10189.skd SkdMonit: Expcode = K10189 SkdMonit: Total Scan # = 2203 SkdMonit: Total Star # = 12 SkdMonit: SkdMonit: 1st Scan = 2010/07/07 20:05:00 3C84 SkdMonit: Last Scan = 2010/07/11 00:00:21 3C84 SkdMonit: SkdMonit: ---------- Station ID Table ---------- SkdMonit: G --- KOGANEI SkdMonit: R --- KASHIM11 SkdMonit: -------------------------------------- SkdMonit: ------- Star Table ------------------- SkdMonit: NAME1 NAME2 R.A.(deg) DEC(deg) EPOCH SkdMonit: 1 0212+735 $ 34.378389 73.825728 2000.000000 SkdMonit: 2 0727-115 $ 112.579635 -11.686833 2000.000000 SkdMonit: 3 1921-293 $ 291.212733 -29.241700 2000.000000 SkdMonit: 4 2134+004 2134+00 324.160776 0.698393 2000.000000 SkdMonit: 5 2145+067 $ 327.022744 6.960723 2000.000000 SkdMonit: 6 1226+023 3C273B 187.277916 2.052388 2000.000000 SkdMonit: 7 1253-055 3C279 194.046527 -5.789312 2000.000000 SkdMonit: 8 1641+399 3C345 250.745042 39.810276 2000.000000 SkdMonit: 9 2223-052 3C446 336.446914 -4.950386 2000.000000 SkdMonit: 10 2251+158 3C454.3 343.490616 16.148211 2000.000000 SkdMonit: 11 0316+413 3C84 49.950667 41.511695 2000.000000 SkdMonit: 12 0923+392 4C39.25 141.762558 39.039126 2000.000000 SkdMonit: -------------------------------------- SkdMonit: ------- Frequency (MHz) Table -------- SkdMonit: Gr# 1 7700.99 U 7710.99 U 7720.99 U 7850.99 U SkdMonit: Gr# 2 8090.99 U 8290.99 U 8490.99 U 8550.99 U SkdMonit: Gr# 3 8570.99 U 8580.99 U 2210.99 U 2220.99 U SkdMonit: Gr# 4 2240.99 U 2290.99 U 2330.99 U 2340.99 U SkdMonit: -------------------------------------- SkdMonit: ------- PCAL Freq (kHz) Table --------- SkdMonit: Gr# 1 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 2 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 3 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 4 4010.0 4010.0 4010.0 4010.0 SkdMonit: --------------------------------------
[Ex.3 Checking a schedule file (set star name)]
$ apri_calc -k10189.skd -source 3C273B <== set star name "3C273B" by option '-source' apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Pickup Source Name : 3C273B <== this is the star name to be picked up ============================================================= SkdMonit: *********** Schedule file monitor ********** SkdMonit: Schedule file = ./k10189.skd SkdMonit: Expcode = K10189 SkdMonit: Total Scan # = 2203 SkdMonit: Total Star # = 12 SkdMonit: SkdMonit: 1st Scan = 2010/07/07 20:05:00 3C84 SkdMonit: Last Scan = 2010/07/11 00:00:21 3C84 SkdMonit: SkdMonit: ---------- Station ID Table ---------- SkdMonit: G --- KOGANEI SkdMonit: R --- KASHIM11 SkdMonit: -------------------------------------- SkdMonit: ------- Star Table ------------------- SkdMonit: NAME1 NAME2 R.A.(deg) DEC(deg) EPOCH SkdMonit: 1 0212+735 $ 34.378389 73.825728 2000.000000 SkdMonit: 2 0727-115 $ 112.579635 -11.686833 2000.000000 SkdMonit: 3 1921-293 $ 291.212733 -29.241700 2000.000000 SkdMonit: 4 2134+004 2134+00 324.160776 0.698393 2000.000000 SkdMonit: 5 2145+067 $ 327.022744 6.960723 2000.000000 SkdMonit: 6 1226+023 3C273B 187.277916 2.052388 2000.000000 SkdMonit: 7 1253-055 3C279 194.046527 -5.789312 2000.000000 SkdMonit: 8 1641+399 3C345 250.745042 39.810276 2000.000000 SkdMonit: 9 2223-052 3C446 336.446914 -4.950386 2000.000000 SkdMonit: 10 2251+158 3C454.3 343.490616 16.148211 2000.000000 SkdMonit: 11 0316+413 3C84 49.950667 41.511695 2000.000000 SkdMonit: 12 0923+392 4C39.25 141.762558 39.039126 2000.000000 SkdMonit: -------------------------------------- SkdMonit: ------- Frequency (MHz) Table -------- SkdMonit: Gr# 1 7700.99 U 7710.99 U 7720.99 U 7850.99 U SkdMonit: Gr# 2 8090.99 U 8290.99 U 8490.99 U 8550.99 U SkdMonit: Gr# 3 8570.99 U 8580.99 U 2210.99 U 2220.99 U SkdMonit: Gr# 4 2240.99 U 2290.99 U 2330.99 U 2340.99 U SkdMonit: -------------------------------------- SkdMonit: ------- PCAL Freq (kHz) Table --------- SkdMonit: Gr# 1 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 2 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 3 4010.0 4010.0 4010.0 4010.0 SkdMonit: Gr# 4 4010.0 4010.0 4010.0 4010.0 SkdMonit: -------------------------------------- SkdMonit: --------- PICKUP SCAN TABLE ---------- <== scans picked up are displayed SkdMonit: SCAN# SOURCE YYYY/DDD HH:MM:SS DURA STATION_IDS SkdMonit: 84 3C273B 2010/189 02:56:33 30 G R SkdMonit: 87 3C273B 2010/189 03:01:02 30 G R SkdMonit: 90 3C273B 2010/189 03:06:44 30 G R ...... SkdMonit: 1791 3C273B 2010/191 10:58:40 30 G R SkdMonit: 1795 3C273B 2010/191 11:09:26 30 G R SkdMonit: 1797 3C273B 2010/191 11:14:24 30 G R SkdMonit: 1799 3C273B 2010/191 11:20:11 30 G R SkdMonit: --------------------------------------
This is a useful to pick up strong source scans.
[Ex.4 Checking a schedule file (set baseline and star name)]
$ apri_calc -eg094a.vex -baseid KsSh -source 3C454.3 <== baseline is selected by option 'baseid' (2 characters for SKED file and 4 chracters for VEX) star name is set by option '-source' apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Pickup Source Name : 3C454.3 <== star name Pickup Baseline ID : KsSh <== baseline ============================================================= search_site: No CLOCK info for ATCA included in the VEX FILE. search_site: So all 0 for clock information was set. search_site: No CLOCK info for PARKES included in the VEX FILE. search_site: So all 0 for clock information was set. ....... search_site: No CLOCK info for IRBENE included in the VEX FILE. search_site: So all 0 for clock information was set. SkdMonit: *********** Schedule file monitor ********** SkdMonit: Schedule file = ./eg094a.vex SkdMonit: Expcode = eg094a SkdMonit: Total Scan # = 74 SkdMonit: Total Star # = 4 SkdMonit: SkdMonit: 1st Scan = 2016/09/20 12:57:00 2223-052 SkdMonit: Last Scan = 2016/09/20 23:47:10 2215+020 SkdMonit: SkdMonit: ---------- Station ID Table ---------- SkdMonit: At --- ATCA SkdMonit: Pa --- PARKES SkdMonit: Mp --- MOPRA SkdMonit: Ho --- HOB_DBBC SkdMonit: Cd --- CDDBBC SkdMonit: Ti --- DSS43LBA SkdMonit: Ks --- KASHIM34 SkdMonit: Ww --- WARK12M SkdMonit: T6 --- TIANMA65 SkdMonit: Ur --- URUMQI SkdMonit: Sh --- SHANGHAI SkdMonit: Bd --- BADARY ...... SkdMonit: Mc --- MEDICINA SkdMonit: O8 --- ONSALA85 SkdMonit: Tr --- TORUN SkdMonit: Hh --- HART SkdMonit: Ir --- IRBENE SkdMonit: (Note that 1 char station ID is not defined in a VEX file) SkdMonit: -------------------------------------- SkdMonit: ------- Star Table ------------------- SkdMonit: NAME1 NAME2 R.A.(deg) DEC(deg) EPOCH SkdMonit: 1 FAKERA 180.000000 85.000000 2000.000000 SkdMonit: 2 2215+020 334.450991 2.336309 2000.000000 SkdMonit: 3 2223-052 336.446914 -4.950386 2000.000000 SkdMonit: 4 3C454.3 343.490616 16.148211 2000.000000 SkdMonit: -------------------------------------- SkdMonit: ------- Frequency (MHz) Table -------- SkdMonit: Gr# 1 1668.00 L 1668.00 U 1668.00 L 1668.00 U SkdMonit: -------------------------------------- SkdMonit: ------- PCAL Freq (kHz) Table --------- SkdMonit: Gr# 1 2000.0 2000.0 2000.0 2000.0 SkdMonit: -------------------------------------- SkdMonit: --------- PICKUP SCAN TABLE ---------- <== scans satisfying star name and baseline are displayed SkdMonit: SCAN# SOURCE YYYY/DDD HH:MM:SS DURA STATION_IDS SkdMonit: 14 3C454.3 2016/264 14:41:30 480 At Pa Mp Ho Cd Ti Ks Ww T6 Ur Sh Bd SkdMonit: 29 3C454.3 2016/264 17:01:00 480 At Mp Ho Cd Ti Ks T6 Ur Sh Bd Sv Zc SkdMonit: --------------------------------------
EXAMPLES (in case of K5/VSSP) |
---|
[Ex.1 Non-interactive operation]
Following example shows non-interactive operation in case that schedule file is "k10189.skd" in the "../corrapri" directory, baseline ID="RG", scan#=8, clock offset=8.0e-6 sec, and the directory of a-priori output is "./".
$ apri_calc k10189.skd -baseid RG -apedir ./ -start 8 -stop 8 -coffset 8.0e-6 apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length Output directory : ./ ============================================================= **************** Schedule File Information ****************** File name --- ./k10189.skd File type --- SKED Exp. code --- K10189 # of stations --- 2 G R # of stars --- 12 # of scans --- 2203 1st Scan : 2010/07/07 20:05:00 3C84 Last Scan : 2010/07/11 00:00:21 3C84 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 -------------------------------- Station ID for X station : R Station ID for Y station : G Selected Baseline is R-G Sampling Information is as follows from schedule file from operator KASHIM11 : 32MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 32MHz 1bit 16CH 0MHz 0bit 0CH Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7700.99MHz U 7710.99MHz U 7720.99MHz U 7850.99MHz U Gr# 2 : 8090.99MHz U 8290.99MHz U 8490.99MHz U 8550.99MHz U Gr# 3 : 8570.99MHz U 8580.99MHz U 2210.99MHz U 2220.99MHz U Gr# 4 : 2240.99MHz U 2290.99MHz U 2330.99MHz U 2340.99MHz U Frequency Group# : 1 Gr# 1 is selected PCAL freq (kHz) : 4010.0 4010.0 4010.0 4010.0 Clock offset and rate : 8e-06 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 2203 Scan range : 8 - 8 8 2010189001135 4C39.25 0 0 0 Apriori File ( ./ape1880008RGa.txt ) created Total # of a-priori files created is 1
[Ex.2 Interactive operation]
$ apri_calc k10189.skd -apedir apeout <== execute with "-apedir" option to set a-priori out ditectory to "apeout" apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length Output directory : apeout <== if this directory does'nt exits, program will stop with warning message. ============================================================= **************** Schedule File Information ****************** File name --- ./k10189.skd File type --- SKED Exp. code --- K10189 # of stations --- 2 G R # of stars --- 12 # of scans --- 2203 1st Scan : 2010/07/07 20:05:00 3C84 Last Scan : 2010/07/11 00:00:21 3C84 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 -------------------------------- Enter Station ID for X station ----> R <== select station ID for X station Enter Station ID for Y station ----> G <== select station ID for Y station Selected Baseline is R-G Sampling Information is as follows from schedule file from operator KASHIM11 : 32MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 32MHz 1bit 16CH 0MHz 0bit 0CH Enter data directory for X station (KASHIM11) ---> ./ <== set X station data directory Enter data directory for Y station (KOGANEI) ---> ./ <== set X station data directory Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7700.99MHz U 7710.99MHz U 7720.99MHz U 7850.99MHz U Gr# 2 : 8090.99MHz U 8290.99MHz U 8490.99MHz U 8550.99MHz U Gr# 3 : 8570.99MHz U 8580.99MHz U 2210.99MHz U 2220.99MHz U Gr# 4 : 2240.99MHz U 2290.99MHz U 2330.99MHz U 2340.99MHz U Enter Frequency Group# ----> 2 <== select frequency group Frequency Group# : 2 Gr# 2 is selected PCAL freq (kHz) : 4010.0 4010.0 4010.0 4010.0 Enter Clock Offset (sec) ----> 0.0 <== set clock offset (reflect clock offset after fringe search) Enter Clock Rate (s/s) -----> 0.0 <== if non zero value is set, epoch will be asked as follows. Enter Clock Epoch (YYYY/DDD-HH:MM:SS|YYYY/MM/DD-HH:MM:SS|YYYYDDDHHMMSS) 0 for each PRT (old style) ----> 2010/07/07-20:05:00 <== enter epoch. If you enter 0, epoch is regarded as each PRT (processing reference time). Clock offset and rate : 0 0 <== here clock rate is reflected Clock Epoch : 0/000 00:00:00 <== here epock is reflected X Clock offset against UTC : 0.000000 <== tis parameter can not be set in case of interactive operation Enter UT1-UTC (sec) ----> 0.0 <== if precise value is not clear, 0 is OK. Enter Wobb X (arcsec) ----> 0.0 <== if precise value is not clear, 0 is OK. Enter Wobb Y (arcsec) ----> 0.0 <== if precise value is not clear, 0 is OK. ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 2203 Enter Start Scan number ----> 8 <== start scan# Enter Stop Scan number ----> 8 <== stop scan# Scan range : 8 - 8 8 2010189001135 4C39.25 0 0 0 Apriori File ( apeout/ape1880008RGb.txt ) created Total # of a-priori files created is 1
[Ex.3 Interactive operation (limited star name)]
$ apri_calc k10189.skd -source 3C273B <== star name is limited to "3C273B" by option '-source' apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length Pickup Source Name : 3C273B <== radio star name Output directory : ../corrapri/ ============================================================= **************** Schedule File Information ****************** File name --- ./k10189.skd File type --- SKED Exp. code --- K10189 # of stations --- 2 G R # of stars --- 12 # of scans --- 2203 1st Scan : 2010/07/07 20:05:00 3C84 Last Scan : 2010/07/11 00:00:21 3C84 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 -------------------------------- Enter Station ID for X station ----> R Enter Station ID for Y station ----> G Selected Baseline is R-G Sampling Information is as follows from schedule file from operator KASHIM11 : 32MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 32MHz 1bit 16CH 0MHz 0bit 0CH Enter data directory for X station (KASHIM11) ---> ./ Enter data directory for Y station (KOGANEI) ---> ./ Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7700.99MHz U 7710.99MHz U 7720.99MHz U 7850.99MHz U Gr# 2 : 8090.99MHz U 8290.99MHz U 8490.99MHz U 8550.99MHz U Gr# 3 : 8570.99MHz U 8580.99MHz U 2210.99MHz U 2220.99MHz U Gr# 4 : 2240.99MHz U 2290.99MHz U 2330.99MHz U 2340.99MHz U Enter Frequency Group# ----> 1 Frequency Group# : 1 Gr# 1 is selected PCAL freq (kHz) : 4010.0 4010.0 4010.0 4010.0 Enter Clock Offset (sec) ----> 0 Enter Clock Rate (s/s) -----> 0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 Enter UT1-UTC (sec) ----> 0 Enter Wobb X (arcsec) ----> 0 Enter Wobb Y (arcsec) ----> 0 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 2203 Enter Start Scan number ----> 0 <== 0 means all scans Enter Stop Scan number ----> 0 <== 0 means all scans Scan range : 1 - 2203 84 2010189025648 3C273B 0 0 0 <== scans for 3C273B are extracted Apriori File ( ../corrapri/ape1880084RGa.txt ) created 87 2010189030117 3C273B 0 0 0 Apriori File ( ../corrapri/ape1880087RGa.txt ) created 90 2010189030659 3C273B 0 0 0 ........ Apriori File ( ../corrapri/ape1881797RGa.txt ) created 1799 2010191112026 3C273B 0 0 0 Apriori File ( ../corrapri/ape1881799RGa.txt ) created Total # of a-priori files created is 168
[Ex.4 Non-interactive operation of Ex.3]
$ apri_calc k10189.skd ../corrapri RG 0 0 1 0 0 ./ ./ 0 0 0 1 0 0 3C273B apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode OFF: PRT is set based on the longest scan Pickup Source Name : 3C273B Output directory : ../corrapri ============================================================= **************** Schedule File Information ****************** File name --- ./k10189.skd File type --- SKED Exp. code --- K10189 # of stations --- 2 G R # of stars --- 12 # of scans --- 2203 1st Scan : 2010/07/07 20:05:00 3C84 Last Scan : 2010/07/11 00:00:21 3C84 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 -------------------------------- Station ID for X station : R Station ID for Y station : G Selected Baseline is R-G Sampling Information is as follows from schedule file from operator KASHIM11 : 32MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 32MHz 1bit 16CH 0MHz 0bit 0CH Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7700.99MHz U 7710.99MHz U 7720.99MHz U 7850.99MHz U Gr# 2 : 8090.99MHz U 8290.99MHz U 8490.99MHz U 8550.99MHz U Gr# 3 : 8570.99MHz U 8580.99MHz U 2210.99MHz U 2220.99MHz U Gr# 4 : 2240.99MHz U 2290.99MHz U 2330.99MHz U 2340.99MHz U Frequency Group# : 1 Gr# 1 is selected PCAL freq (kHz) : 4010.0 4010.0 4010.0 4010.0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 2203 Scan range : 1 - 2203 84 2010189025648 3C273B 0 0 0 Apriori File ( ../corrapri/ape1880084RGa.txt ) created 87 2010189030117 3C273B 0 0 0 ........... Apriori File ( ../corrapri/ape1881797RGa.txt ) created 1799 2010191112026 3C273B 0 0 0 Apriori File ( ../corrapri/ape1881799RGa.txt ) created Total # of a-priori files created is 168
A-priori files are created under the "apeout" directory. If a-priori output directory is not specified, a-priori files are created under the "../corrapri" directory.
EXAMPLES (in case of VDIF Format Data) |
---|
$ apri_calc ..sked/ks15002.skd -format VDIF <== Data format "VDIF" is specified by "-format VDIF" option apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length X station data format : VDIF <== specified data format for X station Y station data format : VDIF <== specified data format for Y station Output directory : ../corrapri/ ============================================================= **************** Schedule File Information ****************** File name --- ../src/ks15002.skd File type --- SKED Exp. code --- KS15002 # of stations --- 5 G R Y B O # of stars --- 16 # of scans --- 289 1st Scan : 2015/01/02 02:00:00 3C345 Last Scan : 2015/01/03 02:02:43 0059+581 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 Y --- TATEYAMA B --- MIURA O --- KASHIM34 -------------------------------- Enter Station ID for X station ----> R Enter Station ID for Y station ----> G Selected Baseline is R-G Sampling Information is as follows (display sampling information) from schedule file from operator KASHIM11 : 16MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 16MHz 1bit 16CH 0MHz 0bit 0CH Enter data directory for X station (KASHIM11) ---> ./ <== set data directory for X station Enter data directory for Y station (KOGANEI) ---> ./ <== set data directory for X station Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7864.99MHz U 7874.99MHz U 7884.99MHz U 8014.99MHz U Gr# 2 : 8114.99MHz U 8244.99MHz U 8504.99MHz U 8544.99MHz U Gr# 3 : 8564.99MHz U 8574.99MHz U 2214.99MHz U 2224.99MHz U Gr# 4 : 2234.99MHz U 2264.99MHz U 2294.99MHz U 2304.99MHz U Enter Frequency Group# (0 for all) ----> 0 <== select all frequencies All frequency mode is selected! Enter Clock Offset (sec) ----> 0 Enter Clock Rate (s/s) -----> 0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 Enter UT1-UTC (sec) ----> 0 Enter Wobb X (arcsec) ----> 0 Enter Wobb Y (arcsec) ----> 0 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 289 Enter Start Scan number ----> 1 Enter Stop Scan number ----> 2 Scan range : 1 - 2 1 2015002020045 3C345 0 0 0 Apriori File ( ../corrapri/ape0020001RG.txt ) created 2 2015002020520 3C454.3 0 0 0 Apriori File ( ../corrapri/ape0020002RG.txt ) created Total # of a-priori files created is 2
Edit an a-priori file by a text editor if necessary.
EXAMPLES (in case of Mark-5B format Data) |
---|
$ apri_calc ..sked/ks15002.skd -format M5B <== Data format "Mark-5B" is specified by "-format M5B" option apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length X station data format : Mark-5B <== specified data format for X station Y station data format : Mark-5B <== specified data format for Y station ============================================================= **************** Schedule File Information ****************** File name --- ../src/ks15002.skd File type --- SKED Exp. code --- KS15002 # of stations --- 5 G R Y B O # of stars --- 16 # of scans --- 289 1st Scan : 2015/01/02 02:00:00 3C345 Last Scan : 2015/01/03 02:02:43 0059+581 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 Y --- TATEYAMA B --- MIURA O --- KASHIM34 -------------------------------- Enter Station ID for X station ----> R Enter Station ID for Y station ----> G Selected Baseline is R-G Sampling Information is as follows (display sampling information) from schedule file from operator KASHIM11 : 16MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 16MHz 1bit 16CH 0MHz 0bit 0CH Enter data directory for X station (KASHIM11) ---> ./ <== set data directory for X station Enter data directory for Y station (KOGANEI) ---> ./ <== set data directory for Y station Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7864.99MHz U 7874.99MHz U 7884.99MHz U 8014.99MHz U Gr# 2 : 8114.99MHz U 8244.99MHz U 8504.99MHz U 8544.99MHz U Gr# 3 : 8564.99MHz U 8574.99MHz U 2214.99MHz U 2224.99MHz U Gr# 4 : 2234.99MHz U 2264.99MHz U 2294.99MHz U 2304.99MHz U Enter Frequency Group# (0 for all) ----> 0 <== select all frequencies All frequency mode is selected! Enter Clock Offset (sec) ----> 0 Enter Clock Rate (s/s) -----> 0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 Enter UT1-UTC (sec) ----> 0 Enter Wobb X (arcsec) ----> 0 Enter Wobb Y (arcsec) ----> 0 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 289 Enter Start Scan number ----> 1 Enter Stop Scan number ----> 2 Scan range : 1 - 2 1 2015002020045 3C345 0 0 0 Apriori File ( ../corrapri/ape0020001RG.txt ) created 2 2015002020520 3C454.3 0 0 0 Apriori File ( ../corrapri/ape0020002RG.txt ) created Total # of a-priori files created is 2
Edit an a-priori file by a text editor if necessary.
EXAMPLES (in case of VSSP format for X station and VDIF format Y station) |
---|
$ apri_calc ..sked/ks15002.skd -formY VDIF <== Y station data format is specified by "-formY" option to VDIF X station is default format (VSSP) apri_calc (Ver. 2016-10-12) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length Y station data format : VDIF <== display specified data format ============================================================= **************** Schedule File Information ****************** File name --- ../src/ks15002.skd File type --- SKED Exp. code --- KS15002 # of stations --- 5 G R Y B O # of stars --- 16 # of scans --- 289 1st Scan : 2015/01/02 02:00:00 3C345 Last Scan : 2015/01/03 02:02:43 0059+581 ************************************************************* ------ STATION ID TABLE -------- G --- KOGANEI R --- KASHIM11 Y --- TATEYAMA B --- MIURA O --- KASHIM34 -------------------------------- Enter Station ID for X station ----> R Enter Station ID for Y station ----> G Selected Baseline is R-G Sampling Information is as follows (display sampling information) from schedule file from operator KASHIM11 : 16MHz 1bit 16CH 0MHz 0bit 0CH KOGANEI : 16MHz 1bit 16CH 0MHz 0bit 0CH Enter data directory for X station (KASHIM11) ---> ./ <== set data directory for X station Enter data directory for Y station (KOGANEI) ---> ./ <== set data directory for Y station Data directory for X station (KASHIM11) : ./ Data directory for Y station (KOGANEI) : ./ Frequency group and frequencies Gr# 1 : 7864.99MHz U 7874.99MHz U 7884.99MHz U 8014.99MHz U Gr# 2 : 8114.99MHz U 8244.99MHz U 8504.99MHz U 8544.99MHz U Gr# 3 : 8564.99MHz U 8574.99MHz U 2214.99MHz U 2224.99MHz U Gr# 4 : 2234.99MHz U 2264.99MHz U 2294.99MHz U 2304.99MHz U Enter Frequency Group# ----> 1 <== select one of groups All frequency mode is selected! Enter Clock Offset (sec) ----> 0 Enter Clock Rate (s/s) -----> 0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0.000000 Enter UT1-UTC (sec) ----> 0 Enter Wobb X (arcsec) ----> 0 Enter Wobb Y (arcsec) ----> 0 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 289 Enter Start Scan number ----> 1 Enter Stop Scan number ----> 2 Scan range : 1 - 2 1 2015002020045 3C345 0 0 0 Apriori File ( ../corrapri/ape0020001RG.txt ) created 2 2015002020520 3C454.3 0 0 0 Apriori File ( ../corrapri/ape0020002RG.txt ) created Total # of a-priori files created is 2
Edit an a-priori file by a text editor if necessary.
EXAMPLES (in case of VDIF format for X and Y stations, but single-CH/thread data for Y station) |
---|
$ apri_calc ../sked/q19311.skd -apedir ../work -formX VDIF 16M2B8C -formY VDIF 16M2B1C -threadY MULTI apri_calc (Ver. 2019-12-03) ====================== RUN CONDITION ======================== K5 file naming type is Type 1 : sidDDDNNNN.dat (SKED deflt) Sub-net mode ON : PRT is set according to each scan length X station data format : VDIF Y station data format : VDIF Output directory : ../work ============================================================= **************** Schedule File Information ****************** File name --- ../sked/q19311.skd File type --- SKED Exp. code --- Q19311 # of stations --- 2 M V # of stars --- 88 # of scans --- 28 1st Scan : 2019/11/07 10:00:00 2229+695 Last Scan : 2019/11/07 10:59:15 0805+410 ************************************************************* ------ STATION ID TABLE -------- M --- MK-VLBA V --- WETTZELL -------------------------------- Enter Station ID for X station ----> M Enter Station ID for Y station ----> V Selected Baseline is M-V Sampling Information is as follows from schedule file from operator MK-VLBA : 16MHz 2bit 8CH 16MHz 2bit 8CH WETTZELL : 16MHz 2bit 8CH 16MHz 2bit 1CH Enter data directory for X station (MK-VLBA) ---> ./ Enter data directory for Y station (WETTZELL) ---> ./ Data directory for X station (MK-VLBA) : ./ Data directory for Y station (WETTZELL) : ./ Frequency group, frequency, sideband, polarization based on MK-VLBA are Gr# 1 : 8365.75 MHz U 8445.75 MHz U 8805.75 MHz U 8925.75 MHz U Gr# 2 : 2232.75 MHz U 2262.75 MHz U 2372.75 MHz U 2392.75 MHz U Select Frequency Group#(s) (e.g. 1 [2 3 4 ...]) or 0 for all ----> 0 All frequency mode is selected! Enter Clock Offset (sec) ----> 0 Enter Clock Rate (s/s) -----> 0 Clock offset and rate : 0 0 Clock Epoch : 0/000 00:00:00 X Clock offset against UTC : 0 Enter UT1-UTC (sec) ----> 0 Enter Wobb X (arcsec) ----> 0 Enter Wobb Y (arcsec) ----> 0 ut1,wobbx,wobby : 0.000000 0.000000 0.000000 # of scans --- 28 Enter Start Scan number ----> 1 Enter Stop Scan number ----> 1 Scan range : 1 - 1 1 2019311100020 2229+695 0 0 0 Apriori File ( ../work/ape3110001MV.txt ) created Total # of a-priori files created is 1
A-priori file created is as follows.
** This is Apriori file made by apri_calc Ver. 2019-12-03 ** for cor, cor_all, fx_cor, and fx_cor_all ** ** (X clock offset wrt UTC is not reflected to a-priori values) ** ** SUBNET ON: PRT is set according to each scan length ** ** Clock parameters at run are as follows, ** Clock Offset (s) : 0.000000 ** Clock Rate (s/s) : 0.000000 ** Clock Epoch : 0000/000 00:00:00 ** ** $EXPCODE Q19311 $OBS_NUMBER 1 $STATION1 MK-VLBA ./M3110001 $FORMAT1 VDIF 16MHz 8CH 2bit $XYZ-STATION1 -5464074.952510 -2495249.107380 2148296.843470 $STATION2 WETTZELL ./V3110001 $FORMAT2 VDIF 16MHz 1CH 2bit <= Note that # of CHs should be 1 because of single-CH/thread data! $XYZ-STATION2 4075539.899410 931735.270250 4801629.351850 $BASEID MV $FRQ_GRP(1-2) 0 $FREQUENCY 8365750000.0 U 1 1 -- (0-0) <== inside ( ) shows thread#s for X and Y data 8445750000.0 U 2 2 -- (0-1) 8805750000.0 U 3 3 -- (0-2) 8925750000.0 U 4 4 -- (0-3) 2232750000.0 U 5 5 -- (0-4) 2262750000.0 U 6 6 -- (0-5) 2372750000.0 U 7 7 -- (0-6) 2392750000.0 U 8 8 -- (0-7) $PCAL_FREQ 10000.0 10000.0 10000.0 10000.0 10000.0 10000.0 10000.0 10000.0 $CLOCK OFST= 0.000000 RATE= 0.000000 XCOF= 0.000000 $SOURCE 2229+695 $RA 22 30 36.46970500 $DEC 69 46 28.07690000 $EPOCH 2000.0 $GHA 14 34 58.530000 $EOP UT1-UTC= 0.000000 X_WOBB = 0.000000 Y_WOBB = 0.000000 $START 2019311100000 $STOP 2019311100040 $APRIORI PRT=2019311100020 TAU0= -2.210227274619678e-03 TAU1= -7.220902109727506e-07 TAU2= -3.243827760964927e-11 TAU3= 3.811317364141309e-15 $END