K5/VSSP32サンプラーユニット

環境	備考
Debian GNU/Linux 3.1 (kernel 2.6.8-2-386) i386 プラットフォーム	オリジナルドライバーの動作環境
Debian GNU/Linux 4.1 (kernel 2.6.18-4-686) i386 プラットフォーム	ただしFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
Debian GNU/Linux 5.0 (kernel 2.6.26-1-686)	vlbi-usb-linux-1.18.tar.gz を使用
CentOS GNU/Linux (kernel 2.6.9-42.ELsmp) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと
CentOS 5 GNU/Linux (kernel 2.6.18-53.el5) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと 更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
CentOS 5 GNU/Linux (kernel 2.6.18-164.el5) i386 プラットフォーム	vlbi-usb-linux-1.18.tar.gz を使用
Fedora Core GNU/Linux (kernel 2.6.18-1.2798.fc6) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと 更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
Fedora14 GNU/Linux (kernel 2.6.35.10-74.fc14.i686)	vlbi-usb-linux-01TK.tar.gz を使用
Ubuntu10.10 GNU/Linux (kernel 2.6.35-22-generic) i686	vlbi-usb-linux-2011-01TK.tar.gz を使用
Ubuntu11.04 GNU/Linux (kernel 2.6.38-8-generic) i686	vlbi-usb-linux-2011-10TK.tar.gz を使用
Ubuntu12.04 GNU/Linux (kernel 3.2.0-86-generic) i686	vlbi-usb-linux-2011-10TK.tar.gz を使用
Ubuntu14.04(64bit) GNU/Linux (kernel 3.13.0-66-generic) x86_64	vlbi-usb-linux64-2011-10TK.tar.gz を使用

サンプラー依存ソフト（K5/VSSPまたはK5/VSSP32用に別々にコンパイルする必要有り）

signalcheck	ボードに10MHzおよび1PPSが供給されているかどうかのチェックプログラム
timesettk	ボードの時刻のセット（ログ機能を追加）
timeadjust	K5/VSSP(K5/VSSP32)の時刻を秒単位（進み遅れ）でセットする（ログ出力あり）
timedisp	ボードの時刻表示
timesync	ボードの１ＰＰＳ同期および時刻表示（ログ機能を追加）
sampling	手動によるデータ収集
sampling2	手動によるデータ収集(高機能版：１秒ファイル生成モードではシンクパターンのチェックあり)
autoobs	自動データ収集。ログ出力機能と複数ハードディスクサポート。 「NOZOMI」観測モードサポート。サブネット観測対応。
monit	K5/VSSP(IP-VLBI)ボードおよびK5/VSSP32の入力信号レベルのモニター。時刻表示有り
monit2	主にK5/VSSP32のエラー回数モニター
setdcoffset	K5/VSSP32ボードのDCオフセットのセット（ログ出力あり）
pctimeset	ＰＣの時刻をK5/VSSP(K5/VSSP32)ボードの時刻に合わせる（ログ出力あり）
timesetpc	K5/VSSP(K5/VSSP32)の時刻をＰＣの時刻に合わせる（ボードテスト用、ログ出力あり）
timecheck	K5/VSSP32の時刻表示の誤動作チェック（ログ出力あり）

サンプラー不要のソフト

datachk	データチェック （ヘッダー部を頼りにヘッダー間のデータビット数をカウント）。オプションでサンプリング統計表示機能
oscillo	サンプリングデータの時系列ダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana	オフラインスペクトル表示（speana2の機能実装済み）
speana_n	オフラインスペクトルのダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana2	オフラインスペクトル表示(高機能版）
skdchk	スケジュールファイルのチェック
extdata	サンプリングデータファイルから特定のｃｈのデータを抽出しテキストファイルに書き出す
four2one	４chモードで収集したデータから任意のチャンネルのデータを切り出し、１chモードのデータに変換する
datacut	サンプリングデータファイルからある時間範囲のデータを抜き出す
datatime_edit	サンプリングデータファイルの時刻を修正（変更）する
adbitconv	サンプリングデータファイルのADビット数を任意のADビット数（ただし、1,2,4,8）に変換する
one2four	４台のＩＰ−ＶＬＢＩボードから１ｃｈモードで取得したデータファイル４つを結合し、 4ｃｈモードのデータファイルを作成する
data_half	サンプリングデータを間引きすることにより見かけのサンプリング周波数を半分にする
data_double	サンプリングデータを繰り返すことにより見かけのサンプリング周波数を倍にする
k5v32tok5	K5/VSSP32フォーマットデータをK5/VSSPフォーマットに変換する
k5tok5v32	K5/VSSPフォーマットデータをK5/VSSP32フォーマットに変換する
data_recov	K5/VSSPおよびK5/VSSP32データヘッダー部の修復を行う
vssplogana	sampling（autoobsも可）のログファイルおよびdatachkのサマリー出力ファイルを解析し、 発生エラー状況の統計結果を表示する
aux_recov	K5/VSSP32データでデータチェック時にAUX MISALIGN (misaligned AUX field)と表示されるデータの修復を行う
pcalcheck	K5/VSSPおよびVSSP32データファイル中のPCAL位相と強度をグラフ表示する

ボードテスト用シェルスクリプト（観測ソフト群のアーカイブに含まれています） Version 2007-03-02

vssp32test.sh	K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト
vssp32test2.sh	K5/VSSP32ユニットのサンプリングパラメータを固定して、繰り返しの耐久テスト
vssp32test3.sh	K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト。下限周波数の設定可

K5/VSSP <-> Mark5フォーマット変換ソフト群（Version 2016-07-21）

k5tom5	K5からMark5への変換(K5/VSSP32フォーマットもサポート）
k5tom5b	K5からMark5Bへの変換(K5/VSSP32フォーマットもサポート）UPDATED
m5check	Mark5のファイル形式チェック（8|16|32|64トラックモードの自動判定） およびシンクブロックチェックなしでのヘッダー部表示
m5time	Mark5データの時刻表示
m5btime	Mark5Bデータの時刻表示
m5tok5	Mark5からK5への変換（Mark5全モード対応高速版：K5/VSSP32への変換は未対応）
m5btok5	Mark5BからK5への変換
m5vex_ana	ＶＥＸファイルの解析を行う
m5b_recov	k5tom5bのVer.2016-07-20以前で変換したMark5Bファイルの不具合 （0hUTCをまたぐスキャンで発生）の修正を行なうNEW

ADS3000+(DBBCモード) <-> K5/VSSPフォーマット変換ソフト群（Version 2010-06-21）

ads2k5	ADS3000+のDBBCモードデータからVSSP32またはVSSPフォーマットへの変換

VDIFフォーマット <-> K5フォーマット変換ソフト群（Version 2016-08-08）

vdif2k5	VDIFからK5/VSSP32フォーマットへの変換を行う NEW
vdifcheck	VDIFのファイル形式をチェックする NEW
speana_vdif	VDIFデータのスペクトル表示 NEW
k5tovdif	K5からVDIFへのフォーマット変換を行う NEW

すでにサンプラーのドライバーは別途インストールされているものと します

1.	適当なディレクトリにipvlbi_obs20160808.tar.gz （IP-VLBI(K5/VSSP)ユーティリティVer.2016-08-03) を置く
2.	tar xvzf ipvlbi_obsXXXXXXXX.tar.gz で解凍する
3.	cd ipvlbiXXXXXXXX で作業ディレクトリを移動する（Ver.2005-06-17およびそれ以前は解凍したディレクトリにとどまる）
4.	【この項大幅更新】 注：Ver.2010-02-07より前のアーカイブの場合は、インストールのデフォルトがK5/VSSPとなっていますので、 K5/VSSP32をインストールする場合は、install_obs.shの代わりにinstall_obs_vssp32.shを使用してください。 Ver.2010-02-07以降のアーカイブを使ってK5/VSSPをインストールする場合はinstall_obs.shの代わりに install_obs_vssp.shを使用してください。 Ver.2010-02-07以降のアーカイブを使ってK5/VSSP32システムをインストールするには、 install_obs.sh を実行してください。 ここで従来(Ver.2007-10-30以前）のようにsourceコマンドは 使用しないでinstall_obs.shを直接実行してください。実行権が適切にセットされて いない場合はセットしてください。 グラフィック表示はデフォルトではPGPLOTですが、GNUPLOTを使用したい 場合はそれぞれのシェルスクリプト実行時にオプションG=GNUPLOTをつけて実行してください。VSSP32の 場合は　install_obs.sh G=GNUPLOT のようになります。 FreeBSDシステムでは /usr/lib/libg2c.so: warning: tempnam() possibly used unsafely; consider using mkstemp() という警告メッセージが出ますが、これはインストールされているPGPLOTパッケージ中の関数に関する警告ですので 無視してください。 linuxシステムにてコンパイル時に警告メッセージが多く出る場合は、 install_obs.64.shをお使い下さい。（install_obs.64.shはファイルオープンにfopen64を使用したコンパイル を行います）
5.	【環境の設定を行う】 インストールしたソフト群のディレクトリが例えば$HOME/K5/ipvlbiXXXXXXXXである場合 シンボリックリンクで ln -s $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi すでにリンクがある場合新しく貼り直す場合は"f"オプションをつけて、 ln -sf $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi でリンクを作成し、.bashrcなどのリソースファイル中で export PATH=$PATH:$HOME/ipvlbi/bin (.bashrcの場合） setenv PATH $PATH:$HOME/ipvlbi/bin (.cshrcの場合） を記述しておけば、K5ソフト群のバージョンアップを行った際もシンボリックリンクを張り直すだけで良くなる。 Ver.2010-02-08以降のアーカイブではmanページファイルも含まれているので、.bashrcなどに export MANPATH=$HOME/ipvlbi/man:$MANPATH (.bashrcの場合） setenv MANPATH $HOME/ipvlbi/man:$MANPATH (.cshrcの場合） を記述しておけば、manコマンド(例えば"man autoobs"等)でK5ソフト群の使用方法を得ることができる。なお、"man k5util"を実行することにより、K5ソフト群全体の説明を得ることができる。