fill_win_channelTableコマンド マニュアル

(The documentation of fill_win_channelTable command)
Last Update: 2023/8/28

◆機能・用途(Purpose)

WINシステム用のチャンネルテーブルにおいて行内で欠けている情報を補完する。
Fill the lacking information in each line of a channel table file for the WIN system.
WINシステム用のチャネルテーブルでは 第14-18列(緯度、経度、標高、観測点補正値)は 1つの観測点につき1つ書けば良い仕様になっている。 そのため処理したいトレースの観測点座標がその行内で得られずに 同じ観測点の別の成分が書かれた行を探索しなければならないケースがあり、 awkなどのスクリプトを用いて処理する際に不便である。 そこでこのコマンドではそのようなチャンネルテーブルファイルを読み込み、 全ての列の情報が全ての行に書かれたチャンネルテーブルファイルを出力する。
The 14-18th columns (latitude, longitude, altitude, station corrections) of a channel table file for the WIN system can be omitted as long as these informations are available from the different channel of the same station. This is inconvenient for processing the channel table by a script (e.g., awk) because the station coordinate of a target trace may not necessarily be obtained from the line of the trace; the lines for the same station must be searched. To avoid this difficulty, this command reads a channel table file and outputs an alternative channel table file in which all information are available within each line.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/win_data/src/fill_win_channelTable.c


◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。 パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

引数
Argument 		与える値
Quantity to be given
第1引数
1st argument 		読み込むチャンネルテーブルファイル名。 有効期間が書かれたymaeda_opentools拡張形式 ( WINファイルのデータフォーマット参照) が利用可能である。
The name of the channel table file to read, which can include the effective periods (an extension of ymaeda_opentools; see The data format of a WIN file).
第2引数
2nd argument 		出力するチャンネルテーブルファイル名。 これも有効期間を含んだymaeda_opentools拡張形式となる。
The output channel table file name. This file may also include the effective periods as an extension of ymaeda_opentools.


●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

このコマンドでは「--パラメータ名=パラメータ値」の形式の引数存在しない。
This command does not have arguments of a form “--Parameter name=Parameter Value”.

◆動作(Behaviour)

第1引数で指定したチャンネルテーブルファイルを読み込み、 全ての行に観測点座標と観測点補正値を含んだチャンネルテーブルを 第2引数で指定したファイルに出力する。
Read the channel table file specified by the 1st argument, and output an alternative channel table file, specified by the 2nd argument, where the station coordinates and station corrections are written in every line.

◆使用例(Example)

fill_win_channelTable channels.tbl.original channels.tbl.filled

(channels.tbl.original)
# NU.NGY1 (-2022/03/20 12:00:00)
9991 1 0 NU.NGY1 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15490 136.96912 56 0 0 --end=2022/03/20_12:00:00
9992 1 0 NU.NGY1 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06 --end=2022/03/20_12:00:00
9993 1 0 NU.NGY1 E 7 24 800 m/s 1.0 0.7 20 2.4445e-06 --end=2022/03/20_12:00:00

# NU.NGY1 (2022/03/20 13:00:00-)
9991 1 0 NU.NGY1 U 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0 --start=2022/03/20_13:00:00
9992 1 0 NU.NGY1 N 6 24 400 m/s 1.0 0.7 0 5.961e-07 --start=2022/03/20_13:00:00
9993 1 0 NU.NGY1 E 6 24 400 m/s 1.0 0.7 0 5.961e-07 --start=2022/03/20_13:00:00

# NU.NGY2
999A 1 0 NU.NGY2 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06
999B 1 0 NU.NGY2 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06
999C 1 0 NU.NGY2 E 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0

(channels.tbl.filled)
9991 1 0 NU.NGY1 U 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.154900 136.969120 56.000000 0.000 0.000 --end=2022/03/20_12:00:00
9992 1 0 NU.NGY1 N 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.154900 136.969120 56.000000 0.000 0.000 --end=2022/03/20_12:00:00
9993 1 0 NU.NGY1 E 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.154900 136.969120 56.000000 0.000 0.000 --end=2022/03/20_12:00:00
9991 1 0 NU.NGY1 U 6 24 4.000000e+02 m/s 1.000 0.700 0.000000e+00 5.961000e-07 35.154900 136.969120 56.000000 0.000 0.000 --start=2022/03/20_13:00:00
9992 1 0 NU.NGY1 N 6 24 4.000000e+02 m/s 1.000 0.700 0.000000e+00 5.961000e-07 35.154900 136.969120 56.000000 0.000 0.000 --start=2022/03/20_13:00:00
9993 1 0 NU.NGY1 E 6 24 4.000000e+02 m/s 1.000 0.700 0.000000e+00 5.961000e-07 35.154900 136.969120 56.000000 0.000 0.000 --start=2022/03/20_13:00:00
999A 1 0 NU.NGY2 U 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.155030 136.969080 56.000000 0.000 0.000
999B 1 0 NU.NGY2 N 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.155030 136.969080 56.000000 0.000 0.000
999C 1 0 NU.NGY2 E 7 24 8.000000e+02 m/s 1.000 0.700 2.000000e+01 2.444500e-06 35.155030 136.969080 56.000000 0.000 0.000


◆補足(Additional notes)

入力ファイルにおける空行やコメントは出力ファイルでは削除される。 また、上の例のように実数の表現(小数点以下の桁数など)は変更される。
Empty lines and comments in the input file are removed in the output file. Also, the expressions of real numbers (e.g., the number of decimal digits) are modified, as the example above shows.