| cor |
|---|
| 機能 |
|---|
"cor"は１ビットサンプリングデータ処理用に開発されたFX方式の相関処理ソフトウェアであり 予測値ファイルを読み、書かれている情報に従って相関処理を実行する。 相関処理結果はCOUT形式(ファイル名は"coutt"で始まる）で出力される。自己相関処理も可能である。
| 書式 |
|---|
cor afile [options]
| afile | "apri_calc"で作成された予測値ファイル |
| OPTIONS | |
| --version | プログラムのバージョンを表示 |
| --help | プログラムの使用法を表示 |
| -integ integration_time | 総積分時間を設定(sec)。デフォルトはスキャン長 |
| -coffset clock_offset | フリンジサーチ時のクロックオフセット(sec)。 正値はYの時計がXの時計より進んでいることを意味する。デフォルトは0.0 |
| -crate clock_rate | フリンジサーチ時のクロックレート(s/s)。デフォルトは0.0 |
| -soffset start_offset | 開始時刻のオフセット（整数秒単位）。デフォルトは0 |
| -t1pp t1pp | 単位積分時間（PP）の設定 (sec)（デフォルトは 1.0）。 １秒以下の値を指定するときは、１秒を整数で割った値とすること(例：0.2)。デフォルトは1.0 |
| -pp_nosync | PP同期モードを非同期にセット（処理開始可能な時刻からPPを開始）。デフォルトはPPの開始が秒に同期する |
| -lag lagsize | ラグウインドウサイズのセット。2n の値をセットする（例：16, 32, 64, 128, 256, 512, 1024, 2048, ....） |
| -pmode pmode | プロット表示デバイスモード 0: XWINDOWおよびPostScript ファイル(pgplot.ps またはgnuplot.ps）出力（デフォルト） 1: PostScript ファイル(pgplot.ps またはgnuplot.ps）出力のみ 2: XWINDOW 出力のみ -1: グラフ出力無し |
| -comment "any_comment" | |
| コメント（pmode=0,1,2 の場合グラフ上部に表示） | |
| -nopcal | PCAL検出機能を抑制する |
| -ch1 ch1Y | Ｘ局のCH1 と相関処理を行うＹ局のCH を指定（デフォルトは1） |
| -ch2 ch2Y | Ｘ局のCH2 と相関処理を行うＹ局のCH を指定（デフォルトは2） |
| -ch3 ch3Y | Ｘ局のCH3 と相関処理を行うＹ局のCH を指定（デフォルトは3） |
| -ch4 ch4Y | Ｘ局のCH4 と相関処理を行うＹ局のCH を指定（デフォルトは4） |
| 注：fx cor new およびcor new の場合は-ch16 ch16Y までセット可能 | |
| -orule naming_rule | 相関出力ファイルの命名則を指定 0 : プログラム固定ファイル名(coutt.txt)。"fx_cor"の場合はcout.txt 1 : couttNNNN.txt (デフォルト) ここでNNNN ：４桁の通し番号 2 : couttEXP CODE/coutYYDDDNNNNXYG.txt |
| ここで EXP CODE -- 実験コード YY -- 年（２桁） DDD -- 通日（３桁） NNNN -- スキャン番号（４桁） XY -- 基線ＩＤ（２文字または４文字） G -- 周波数グループ(a|b|c|d) またはnull 3 : couttYYDDDNNNNXYG.txt | |
| ここで YY -- 年（２桁） DDD -- 通日（３桁） NNNN -- スキャン番号（４桁） XY -- 基線ＩＤ（２文字または４文字） G -- 周波数グループ(a|b|c|d) またはnull 注： fx_corおよびfx_cor_new処理では出力ファイル名中"coutt"の部分が"cout" となる | |
| -odir outdir | 相関出力ファイル作成ディレクトリを指定する。デフォルトは環境変数K5COUT で指定されるディレクトリ。環境変数が指定されていない場合は、../cout ディレクトリ |
| -rfoffset rf_offset | X局とY 局間のRF 周波数の差を設定(RFy-RFx)(Hz) |
| -cout cout_file | 相関出力ファイル名を強制的に設定する |
| -frstep frstep | フリンジ位相計算ステップの設定 0 -- 自動設定 1 -- 1サンプル毎 8 -- 8サンプル毎（デフォルト） N -- N サンプル毎（1000/N は整数であること） |
| -frauto | フリンジ位相計算ステップを自動設定モードに設定(“-frstep 0” と同じ) |
| -fall pcalf | 全CH のPCAL 周波数を強制的に設定する(kHz) |
| -f1 pcalf1 | CH1 のPCAL 周波数を強制的に設定する(kHz) |
| -f2 pcalf2 | CH2 のPCAL 周波数を強制的に設定する(kHz) |
| -f3 pcalf3 | CH3 のPCAL 周波数を強制的に設定する(kHz) |
| -f4 pcalf4 | CH4 のPCAL 周波数を強制的に設定する(kHz) |
| 注："cor new" および"fx_cor new" の場合は"-f16 pcalf16" までセット可能 | |
| -frmid | フリンジストップを帯域中央で行う（生のフリンジ強度が約10%上昇する。ただし
処理速度はベースバンドで行う場合より若干遅くなる）。
なお、KOMB処理ではベースバンドで行った場合と帯域中央で行った場合のそれぞれの損失補正が
行われるのでKOMB処理結果のフリンジ強度は同じになる。 Ver.2020-08-18以前ではこの機能は無い |
| -frbase | フリンジストップをベースバンドで行う（デフォルト）。 |
===== t1ppとして実際に許される１秒以下の値は以下の表の通り ====
| t1pp | |||||||
| fsampl | 0.01 | 0.02 | 0.04 | 0.05 | 0.1 | 0.2 | 0.5 |
| 40kHz | X | OK | OK | X | OK | OK | OK |
| 100kHz | X | X | OK | X | X | OK | X |
| 200kHz | X | OK | OK | X | OK | OK | OK |
| 500kHz | X | X | OK | X | X | OK | X |
| 1MHz | X | OK | OK | X | OK | OK | OK |
| 2MHz | OK | OK | OK | OK | OK | OK | OK |
| 4MHz | OK | OK | OK | OK | OK | OK | OK |
| 8MHz | OK | OK | OK | OK | OK | OK | OK |
| 16MHz | OK | OK | OK | OK | OK | OK | OK |
| 32MHz | OK | OK | OK | OK | OK | OK | OK |
cor afile [sekibun [soffset [coffset [crate [t1pp [smode [pp_mode [lag_size [tzoom [pmode [comment]]]]]]]]]]]
| afile | "apri_calc"で作成された予測値ファイル |
| sekibun | 総積分時間を設定(sec)。0とするとスキャン長 |
| soffset | 開始時刻のオフセット（整数秒単位）。デフォルトは0 |
| coffset | フリンジサーチ時のクロックオフセット(sec)。正値はYの時計がXの時計より進んでいることを意味する。デフォルトは0.0 |
| crate | フリンジサーチ時のクロックレート(s/s)。デフォルトは0.0 |
| t1pp | 単位積分時間（PP）の設定 (sec)（デフォルトは 1.0）。１秒以下の値を指定するときは、１秒を整数で割った値とすること(例：0.2)。デフォルトは1.0 |
| smode | 一度に処理するサンプル数（遅延サーチ範囲）モード（以下の設定値があるがもはや無意味なパラメータである） 0: 最大200000 点の範囲の相関関数（低速） 1: 中10000 点の範囲サーチ 2: 最小1000（または2000）点の範囲サーチ（高速）（デフォルト） |
| pp_mode | PP同期モード 0: PPの開始が秒に同期する（デフォルト） 1: 非同期。処理開始可能な時刻からPPを開始 |
| lag_size | ラグウインドウサイズ（16,32,64,128,256,512,..）（デフォルトは32） |
| tzoom | 時間軸拡大率（整数） 0 : フルスケール（デフォルト） 1 を指定と等価 -VE : 負の値とすると拡大は最大値を中心としたスケールとなる。拡大率は絶対値 |
| pmode | プロット表示デバイスモード 0: XWINDOW およびPostScript ファイル(pgplot.ps またはgnuplot.ps）出力（デフォルト）) 1: PostScript ファイル(pgplot.ps またはgnuplot.ps）出力のみ 2: XWINDOW 出力のみ -1: グラフ出力無し |
| comment | コメント（グラフ上部に表示）。スペースを含まないこと。 |
cor k5file1 [k5file2] [options]
| k5file1 | データファイル名 (K5/VSSP,VSSP32,VSSP64フォーマット) |
| k5file2 | ２番目のデータファイル名 ディレクトリ名を省略時はk5file1と同じディレクトリにあると見なされる。 またk5file2を省略時はk5file2はk5file1と同じとなる。 k5file1とk5file2の相互相関処理（k5file2を省略時はk5file1の自己相関処理となる）が、 予測値をゼロとして行われる。RF 周波数もゼロにセットされる。 |
cor env
プログラムで使用されている環境変数をチェックする
K5APRIDIR -- 予測値ファイルのディレクトリ
K5COUT -- 相関データ出力ディレクトリ
PGDISP -- PGPLOT のグラフ出力デバイス