| cor_new |
|---|
| 機能 |
|---|
"cor_new"は１ビットサンプリングデータ処理用に開発されたFX方式の相関処理ソフトウェアであり K5/VSSPフォーマット以外に様々なフォーマット （Mark5B, VDIF, ADS, OCTAD)データの相関処理が可能である。 予測値ファイルを読み、書かれている情報に従って相関処理を実行する。 相関処理結果はCOUT形式(ファイル名は"coutt"で始まる）で出力される。
| 書式 |
|---|
【方法１】
cor_new 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検出機能を抑制する |
| -pchx1 ch1 | X局のCH1データとして使用するデータファイル中のチャンネルを指定 (Ver.2018-12-17以降) |
| -pchx2 ch2 | X局のCH2データとして使用するデータファイル中のチャンネルを指定 |
| ............... | |
| -pchx16 ch16 | X局のCH16データとして使用するデータファイル中のチャンネルを指定 |
| -pchy1 ch1 | Y局のCH1データとして使用するデータファイル中のチャンネルを指定 (Ver.2018-12-17以降) |
| -pchy2 ch2 | Y局のCH2データとして使用するデータファイル中のチャンネルを指定 |
| ............... | |
| -pchy16 ch16 | Y局のCH16データとして使用するデータファイル中のチャンネルを指定 |
| -ch1 ch1Y | X局のCH1 と相関処理を行うY局のCH を指定（デフォルトは1） |
| -ch2 ch2Y | X局のCH2 と相関処理を行うY局のCH を指定（デフォルトは2） |
| ............... | |
| -ch16 ch16Y | X局のCH16 と相関処理を行うY局のCH を指定（デフォルトは16） |
| -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) |
| ............... | |
| -f16 pcalf16 | CH16 のPCAL 周波数を強制的に設定する(kHz) |
| -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_new 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_new env
プログラムで使用されている環境変数をチェックする
K5APRIDIR -- 予測値ファイルのディレクトリ
K5COUT -- 相関データ出力ディレクトリ
PGDISP -- PGPLOT のグラフ出力デバイス