datachk

機能

ヘッダー部を頼りにヘッダー間のデータビット数をカウントすることにより、ビットスリップまたはビットメイクが あったかどうかでデータをチェックする。またアナログ信号が＋のサインであった割合を％で表示することや、 多ビットADデータのレベルごとの度数分布の表示も可能である。 更にエラーが起こったデータファイルの記録機能も有する。この機能は、サンプラーの連続試験時にエラーが起こった データファイルだけ保存したい場合に便利な機能である。 なお、このチェックでAUX MISALIGN (misaligned AUX field)と診断されたK5/VSSP32データはaux_recovを使って修復が可能である。

書式

datachk file_name [mode [logfile [errlog [keepmode]]]] [オプション]

file_name データファイル名（デフォルトは tds.data）
mode サンプリング統計表示モード
0 サンプリング統計は表示しない（デフォルト）
最初と最後のフレーム情報およびエラーの生じたフレーム情報のみを表示
1 サンプリング統計（ゼロバランス）を表示する。 ゼロバランス表示はアナログ信号が＋のサインであった割合を％で表示。
2 モード０と同じ。ただし全フレーム表示する
3 ADレベルごとの度数分布を１秒ごとに表示
4 ADレベルごとの度数分布を表示（全データの結果）
logfile モード０の場合にチェック結果のサマリーを出力するファイル名。 このファイル名がの先頭が"-"の場合サマリー出力は既存のファイルに追加されていく。
デフォルトはサマリー出力なし。
errlog モード０の場合にエラーが発生したデータファイルの情報を出力するファイル名。 このファイル名の先頭が"-"の場合、出力は既存のファイルに追加されていく。 チェックしたデータファイルにエラーが無い場合は、このファイルは作成（出力）されない。
デフォルトはエラーログ出力なし。
keepmode モード０の場合にエラーの生じたデータファイルの保存モード
0 何もしない（デフォルト）
1 データファイルの名前を元の名前＋".NNNN.err"に変更する。
2 データファイルを元の名前＋".NNNN.err"にコピーする。 ここでNNNN は 0001 から 9999 で繰り返す。 この通し番号はdatachkを実行するディレクトリ下の "counter_file_datachk.tmp"という名のテキストファイルで管理する。
オプション
-s2 VSSP64データの対してチャンネル数を強制的に２にセットする

実行例

【例１. デフォルトモードで実行】 

	$ datachk G220205919a.dat
	************ datachk  Ver. 2016-09-02 ************
	     [Note: # of bits does not include Header]
	FILE : G220205919a.dat  (480051200 bytes)

	 This is K5/VSSP32 format data.

	  1st Extended Header Info is as follows.
	    Year = 2010    Total Day = 220
	    Version  Major = 1  Minor = 0    # of AUX Bytes = 20
	    AUX Field Data :  20471001 41474F4B 2049454E 6137356B 20202020
	        Format # = 1
	        Filter (MHz)  : 16
	        Station info  : ID2(G ) name(KOGANEI )
	        PC host name  :  k57a


	 FMT A/D CH  f(MHz)  TIME   seconds   # of bits
	VS32  1   4     32 20:59:19  75559     128000000
	    checking.....
	VS32  1   4     32 20:59:49  75589        401664
	Warning! (Frame data not completed) (401664/128000000) <=最後のフレームが完結していないために出た警告

	480051200 bytes read
	    0 frames out of   31 frames (  0.00%) are bad (bit slip) frames.
	    0 frames out of   31 frames (  0.00%) are time discon frames.
	    0 frames out of   31 frames (  0.00%) are time discon and bit slip frames.
	    0 frames out of   31 frames (  0.00%) are EFLG set frames.
	Time elapsed for processing is 0.000916 sec

【例２. ２ビットADデータをmode=4でチェックした例】 

	kondo@qso1:~/chkdata/vdif$ datachk ads_2012300165730.k5a 4
	************ datachk  Ver. 2016-09-02 ************
	     [Note: # of bits does not include Header]
	FILE : ads_2012300165730.k5a  (267840430 bytes)

	 This is K5/VSSP32 format data.

	  1st Extended Header Info is as follows.
	    Year = 2012    Total Day = 300
	    Version  Major = 0  Minor = 0    # of AUX Bytes = 20
	    AUX Field Data :  55550002 55555555 55555555 32534441 2020354B
	        Format # = 2
	        Filter (MHz)  : 0
	        PC host name  :  ADS2K5


	                                                    % of plus sign data
	 FMT A/D CH  f(MHz)  TIME   seconds    # of bits    Ch1    Ch2    Ch3    Ch4
	VS32  2   4     64 16:57:30  61050     512000000   50.0   50.0   50.0   50.0
	VS32  2   4     64 16:57:31  61051     512000000   50.0   50.0   50.0   50.0
	VS32  2   4     64 16:57:32  61052     512000000   50.0   50.0   50.0   50.0
	VS32  2   4     64 16:57:33  61053     512000000   50.0   50.0   50.0   50.0
	VS32  2   4     64 16:57:34  61054      94722144   50.0   50.0   50.0   50.0
	Warning! (Frame data not completed) (94722144/512000000) <=最後のフレームが完結していないために出た警告
	VS32  2   4     64 16:57:34  61054NG

	                        Level Histogram (ALL Data Period)
	LEVEL         CH1               CH2               CH3               CH4
	  0   49151401(18.4%)   46554649(17.4%)   49150728(18.4%)   46654050(17.4%)
	  1   84781824(31.7%)   87370733(32.6%)   84761837(31.6%)   87265832(32.6%)
	  2   84760753(31.6%)   87361932(32.6%)   84778617(31.7%)   87268066(32.6%)
	  3   49146290(18.3%)   46552954(17.4%)   49149086(18.4%)   46652320(17.4%)
	SUM  267840268         267840268         267840268         267840268

	267840428 bytes read
	0 frames out of 5 frames (0.000000%) are bad frames.
	Time elapsed for processing is 5.099330 sec
サマリーファイル例 

	# File Name:
	D:\IPVLBI\data\test02.dat
	# FMT  A/D CH  f(kHz)  LPF(MHz):
	  VS32  1   1   32000       16
	# Start and Last Time:
	  2006/318 23:20:28  84028  
	  2006/318 23:25:27  84327  
	# Duration:
	300
	# Byte offset of 1st header:
	0
	# STATISTICS total bad discon discon_with_bitslip aux_sep EFLG:
	300 1 0 0 147 0
	# BIT SLIP:
	1 26432
エラーログファイル例

keepmode=0の場合 

	# Errored Data File Name:
	test02.dat
	# FMT  A/D CH  f(kHz)  LPF(MHz):
	  VS32  1   1   32000       16

keepmode=1の場合（リネームモード） 

	# Errored Data File Name:
	test02.dat
	# FMT  A/D CH  f(kHz)  LPF(MHz):
	  VS32  1   1   32000       16
	# Renamed to:
	test02.dat.0006.err

keepmode=2の場合（コピーモード） 

	# Errored Data File Name:
	test02.dat
	# FMT  A/D CH  f(kHz)  LPF(MHz):
	  VS32  1   1   32000       16
	# Copied to:
	test02.dat.0007.err

更新日 ２０１６年１２月２６日