vdifcheck

DESCRIPTION

"vdifcheck" checks VDIF format data.

SYNOPSIS

vdifcheck vdif_file [options]

where

vdif_file VDIF format data file name to check
OPTIONS
-f[ormat] 0|1|2|3|99 set display format
0 automatic according to VDIF format and edv# (default)
1 legacy format
2 same as mode=0, but edv# is not considered
3 set edv# compulsory as that of KASHIMA
99 for debug
-d[mode] 0|1|2set display mode
0 display first and last frame only (default)
1 display every frame
2 display frame on the second besides first and last frames
-n[frame] nmaxset # of frames to read
-l[egacy] set header length 16 bytes compulsory
-s[kip] n skip first n bytes data
-k[ashima] [bytesframe]set header format to Kashima format compulsory and set frame length bytesframe bytes compulsory
-pup thread_numset pick up thread# (default 1st encountered thread)
-h[istogram] display occurrence probabilties by AD levels

EXAMPLE 

	$ vdifcheck ./test_sv.vdif -h
	***********************************************************
	*    VDIF data check                                      *
	*      Ver 1.20  2019-10-12  by  T.KONDO                  *
	*                                                         *
	***********************************************************

	Data File : ./test_sv.vdif
	  now analyzing # of threads ......
	  # of threads included is 1
	  thread ID   : 1
	  # of frames in a second  : 16000
	  Thread ID to pick up ==> 1
	 1st header information is as follows

	========================= VDIF HEADER INFORMATION =========================
	 VDIF header (raw)        : 0012F2DD 2700088F 230003EC 04010062
	    extended header (raw) : ABADDEED 00000000 00000000 00000000

	 Invalid flag = 0 :       Legacy flag = 0
	 Sec from ref epoch = 1241821 :  Ref epoch = 39   (2019/07/15 08:57:01)
	 Frame # = 2191 :  VDIF Ver# = 1 : # Chs(log2) = 3
	 Frame length in 8 byte unit = 1004  (= 8032 bytes)
	 Data type = 0 : #bits/sample-1 = 1 : Thread ID = 1
	 Station ID (A2) = b    ( = 98 in number)
	 EDV : -85
	 Exteded Data W1 W2 W3 W4 : ADDEED 00000000 00000000 00000000
	 --- in case of NICT Extended Format ---
	  uflag = 0 :  srate = 0 :  Sync block = 00000000
	  DAS/station name (A8) :
	===========================================================================

	 ==============================================================================
	                                                             EXTENDED DATA
	 HH:MM:SS  FRAME#  I  L  VER  CHS     #Bytes  C AD  TID SID       W1       W2
	 ------------------------------------------------------------------------------
	 08:57:01   2191   0  0    1    8       8032  0  2    1  b 00ADDEED 00000000
	    ...............

	 08:57:09   1681   0  0    1    8       8032  0  2    1  b 00ADDEED 00000000
	 ==============================================================================

	 ============ PROBABILITY(%) OF OCCURRENCES ============
	  LEVEL  CH01  CH02  CH03  CH04  CH05  CH06  CH07  CH08
	 -------------------------------------------------------
	    0     9.3  11.2  25.9  28.0  28.4  28.6  28.4  28.9
	    1    40.7  38.8  24.1  22.0  21.6  21.4  21.6  21.1
	    2    40.7  38.8  24.1  22.0  21.6  21.4  21.6  21.1
	    3     9.3  11.2  25.9  28.0  28.4  28.6  28.4  28.9
	 =======================================================

	========================= SUMMARY =============================
	 File Name   : ./test_sv.vdif
	      Size   : 1024000000 bytes
	 # of threads: 1
	 Start Time  : 2019/07/15 08:57:01
	               Thread ID : 1      Frame# : 2191
	 Bytes/Frame : 8032 bytes
	 Data type   : Real Data        AD bits : 2    #Channels : 8
	 EDV#        : -85
	 # of frames/sec     : 16000
	 # of total frames   : 127491   (#bad frames : 0)
	 Data period (sec)/thread : 7.968187
	 Data Rate/thread (Mbps)  : 1024.000000
	 Sampling Frequency Estimated (MHz) for real : 64.000000
	================================================================

Updated on October 12, 2019