wintosacコマンド マニュアル

(The documentation of wintosac command)
Last Update: 2022/3/25

◆機能・用途(Purpose)

WIN形式の波形データファイルを Seismic Analysis Code (SAC)形式に変換する。
Convert a waveform data file of WIN format to Seismic Analysis Code (SAC) format.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/win_data/src/wintosac.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 		チャンネルコードリストファイル名。 このファイルにはSACファイルを作成したいチャンネルコード(4桁の16進数)を 1行につき1つずつ書く。 A-Fは大文字でも小文字でも良い。 空行と#から後の部分は読み飛ばされるので自由に挿入して良い。
The name of the file in which channel codes are listed. Each line of this file must consist of a channel code (a hexadecimal number of 4-digits) for a channel for which the SAC file is to be created. A-F of the hexadecimal number can be either capital or small letters. Empty lines and comments beginning with # can be inserted, as they are ignored.
第2引数
2nd argument 		変換に用いるチャンネルテーブルファイル名。 WINシステムのチャンネルテーブルフォーマットに準ずるが、 ymaeda_opentools独自の拡張を利用できる。 詳しくは WINファイルのデータフォーマット(winヘッダファイルパッケージ) 参照。
The name of the channel table file used for the conversion. The format of this file is based on the channel table format of the WIN system; however, an extended format for ymaeda_opentools is available. See The data format of a WIN file (in the documentation of win header file package) for detail.
第3引数
3rd argument 		変換したいWINファイル名。
The name of the WIN file to convert.


●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)

第3引数で指定したWINデータファイルを元に、 第1引数で指定した各チャンネルのSAC時系列データファイルを作成する。 出力ファイル名は「観測点コード.成分コード.sac」となる。 観測点コード、成分コードは第2引数で指定したチャンネルテーブルファイルに基づく。
From the WIN data file specified by the 3rd argument, SAC files for individual channels specified by the 1st argument are created. The output file names are “station code.component code.sac”, where station and component codes are based on the channel table file specified by the 2nd argument.

◆使用例(Example)

wintosac ch.code.list channels.tbl 22032208.00

(ch.code.list)
9991
999A

(channels.tbl)
# 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 35.15490 136.96912 56 0 0 --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 35.15490 136.96912 56 0 0 --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 35.15490 136.96912 56 0 0 --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 35.15490 136.96912 56 0 0 --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 35.15503 136.96908 56 0 0
999B 1 0 NU.NGY2 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0
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

この例ではWINデータファイル22032208.00(2022/03/22 08:00の1分ファイル)を元に チャンネル9991, 999AのSACファイルが作成される。 チャンネルテーブルには9991が2度登場するが、 データの期間に合わせて2つ目のパラメータが自動選択される (この選択はWINファイル名ではなく実際のWINデータの中身に基づく)。 出力ファイル名はNU.NGY1.U.sac, NU.NGY2.U.sacとなる。 なお、WINファイルは1分ファイルである必要はなく、名前の付け方も自由である。
In this example, SAC files for channels 9991 and 999A are created from a WIN data file 22032208.00 (a 1-min file at 2022/03/22 08:00). The channel 9991 appears twice in the channel table, and the 2nd parameters are automatically chosen based on the period of the data; this choice is not based on the WIN file name, but based on the actual data in the file. The output file names are NU.NGY1.U.sac and NU.NGY2.U.sac. The WIN data file is not restricted to 1-minute file, and there is no restriction for the name of the WIN data file.