#######################################
## Correlation management toolkit     ##
##   @Author: M.Sekido
##   @Date:  31 May 2007
########################################
1. Purpose/Function

 This toolkit has been developed for automatic management/processing
 of correlation and data format conversion(Mark5,K5/VSSP).
 
 Functions:
   (1). Automatic file conversion agent from Mark5 -> K5/VSSP file by following
      the schedule file.(program: conv_tool5.pl)
   (2). Automatic Job Control for correlation. Accepting notice of
 data file availability from file conversion tool,
 computing available baseline combination and survey the availability
 of correlation servers. Then throw a job to correlation servers.
  (program: cor_mgr.pl)
   (3). Correlation Agent: taking communication to Job Control server
 and perform a correlation processing.(program: cor_srv2.pl)
   (4). Manually noticing of file availability to kick a new processing.(program:msg_sender.pl)


2. Installation
  Copy each program at appropriate places.   
  Default positions are as follows, when $HOME/tool is the
  environmental parameter $path.
 Modules:
    Program name ----+- default dir ----------- 
    conv_tool5.pl      $HOME/tool
    cor_mgr.pl*        $HOME/tool
    cor_srv2.pl*       $HOME/tool
    msg_sender.pl      $HOME/tool
    Obs_com_srv.pm     $HOME/prog/perl/module
    cor_conf.pm        $HOME/prog/perl/module
    Cor_com_clt.pm     $HOME/prog/perl/module
    Cor_com_srv.pm     $HOME/prog/perl/module
    Time_lib.pm	       $HOME/prog/perl/module
  ----------------------------------------------
 If you wish to put perl module (*.pm) files at your preference
  directory, you need to change the line :
  use lib "$ENV{HOME}/prog/perl/module";
 in the perl program (*.pl) files.

3. Usage
  
  (1). File format Conversion tool:
    run as:  
    conv_tool5.pl <m5dir> <skdfile> <-out <dir1> <dir2> <dir3> <dir4>>
     -info <mk5 info file> -host <host:port> -stid <id>
    (port number must be the same with the accepting port number of cor_mgr.pl.)

  (2). Correlation Job Management tool:
   cor_mgr.pl dscor.conf -p 9001
   (With accepting Report at port 9001)

  (3). Correlation Agent:
    cor_srv2.pl  -log corsrv.pl -p 9002
    (Accepting connection at port 9002(default))
  (4). Message Sender
     msg_sender.pl cor_message_u7151.txt -p 9001 -host vlbi3

4. Example of configuration files
 --- Example of config file for cor_mgr.pl -----------------------------
## Distributed correlation Configuration file
$STATION # 
# Station name, ID, notice(1:require notice) 
 Kashima34 O  0 
 Metsahovi Z  1
 Onsala    T  1

$BASELINE
 OT  

$GROUP
 a b c d

$COR
 ## lag  tpp 
   LAG:32  TPP:1
 ## aprdir odir  
   Aprdir:/rashinban/work3/ape/u7150  Odir:/rashinban/work3/cout/coutU7150-2
 ## program
   PROG:fx_cor
$HOSTS
k57a:9002 k57b:9002 k57c:9002 k57d:9002 
k57a:9003 k57b:9003 k57c:9003 k57d:9003 
k55a:9002 k55b:9002 k55c:9002 k55d:9002 
-----------------------------------------------------

-- Example of message file for msg_sender.pl---------------------
Scan: 2007/151-06:00:00 T a
Scan: 2007/151-06:00:00 T b
Scan: 2007/151-06:00:00 T c
Scan: 2007/151-06:00:00 T d
Scan: 2007/151-06:05:00 T a
Scan: 2007/151-06:05:00 T b
Scan: 2007/151-06:05:00 T c
Scan: 2007/151-06:05:00 T d
-----------------------------------------------------


5.Contact
  If you have any request, comments, or bug report, please contact to
  sekido@nict.go.jp.