summarize_win_pick_infoコマンド マニュアル

(The documentation of summarize_win_pick_info command)
Last Update: 2023/7/3

◆機能・用途(Purpose)

WINシステムのpickファイルに記録されている情報を 1観測点につき1行になるように整形する。
Reformat the information recorded in a pick file of the WIN system as all information for each station in a line.
WINシステムでは読み取った走時や震源位置から理論計算した走時などの情報が 1つの地震につき1つのテキストファイル(pickファイル)に記録される。 pickファイルの書式は WINシステムのマニュアル(pickfileの項目) に定義されており、 観測走時や観測点座標は「#s」から始まる行、 理論走時など求まった震源を元に計算される量は「#f」から始まる行に記載される。 このプログラムではこれらの情報を1観測点につき1行になるように合体する。 これにより、シェルスクリプトを使った走時データの処理が 簡単に行えるようになる。
The WIN system records the information of observed and theoretical travel times into a text file (pick file) for each earthquake. The format of the pick file is defined in the documentation of the WIN system (the pickfile entry). In brief, the observed traveltimes and station coordinates are in the lines begining with “#s”, and the quantities calculated from the estimated hypocenter (e.g., theoretical traveltimes) are in the lines beginning with “#f”. This program gathers these information into a single line for each station. By this, processings of the traveltime data by shell scripts become easier.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/win_data/src/summarize_win_pick_info.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 		読み込むpickファイル名。
The input pick file name.
第2引数
2nd argument 		出力ファイル名。
The output file name.


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

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。 デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.
パラメータ名
Parameter name 		意味
Meaning 		可能なパラメータ値
Allowed parameter values 		デフォルト値
Default value
refN 観測点座標を緯度経度から直交座標に換算するための基準点の緯度[°]。
The latitude [°] of the reference point for a conversion of the station coordinates from latitudes and longitudes to cartesian coordinates. 		-90.0以上+90.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -90.0 and less than or equal to +90.0, or its degree:minute:second representation. 		省略時は直交座標を計算しない。
When this parameter is omitted, the cartesian coordinate is not computed.
refE 観測点座標を緯度経度から直交座標に換算するための基準点の経度[°]。
The longitude [°] of the reference point for a conversion of the station coordinates from latitudes and longitudes to cartesian coordinates. 		-180.0以上+180.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -180.0 and less than or equal to +180.0, or its degree:minute:second representation. 		省略時は直交座標を計算しない。
When this parameter is omitted, the cartesian coordinate is not computed.


◆動作(Behaviour)

第1引数で指定したpickファイルから走時データを読み込み、 第2引数で指定したファイルに以下の情報を1観測点につき1行で出力する。 出力ファイルの列の区切りにはタブが用いられる。
Read the traveltime data from the pick file specified by the 1st argument, and output the following information into the file specified by the 2nd argument. In the output file, the information for each station is written in each line, and tabs are used to separate the columns.
列
Column 		値
Value
1 観測点コード。
Station code.
2 P波初動極性。 この観測点で初動極性を読み取っていない場合はNoDataと出力される。
The polarity of the first P-wave motion. If the polarity was not picked at this station, the output is “NoData”.
3 読み取ったP波の観測走時[s]。 pickファイルには適当な「基準時刻」からの経過時間が書かれているが、 これを発震時からの経過時間に換算する。 この観測点でP波を読み取っていない場合はNoDataと出力される。
The observed (picked) P-wave traveltime [s], converted from the original data in the pick file (elapsed time from some “reference time”) to the elapsed time from the earthquake origin time. If the P-wave arrival time was not picked at this station, the output is “NoData”.
4 読み取ったP波の観測走時(観測点補正後)[s]。 pickファイルには適当な「基準時刻」からの経過時間が書かれているが、 これを発震時からの経過時間に換算する。 この観測点でP波を読み取っていない場合はNoDataと出力される。
The observed (picked) P-wave traveltime after the station correction [s], converted from the original data in the pick file (elapsed time from some “reference time”) to the elapsed time from the earthquake origin time. If the P-wave arrival time was not picked at this station, the output is “NoData”.
5 P波の理論走時[s]。 これも発震時からの経過時間で定義する。 この観測点でP波を読み取っていない場合はNoDataと出力される。
The theoretical P-wave travel time [s], defined as the elapsed time from the earthquake origin time. If the P-wave arrival time was not picked at this station, the output is “NoData”.
6 「#s」の行に書かれているP波の観測走時の読み取り誤差[s]。 この観測点でP波を読み取っていない場合はNoDataと出力される。
The picking error of the observed P-wave traveltime [s], written in the “#s” lines. If the P-wave arrival time was not picked at this station, the output is “NoData”.
7 「#f」の行に書かれているP波時刻の精度[s]。 正確な定義は不明だが読み取り誤差とは異なり、 遠方ほど大きくなる傾向にある。 この観測点でP波を読み取っていない場合はNoDataと出力される。
The accuracy [s] of the P-wave arrival time written in the “#f” lines. The exact definition is not clear, but this value is different from the picking error and tends to be larger at greater distances. If the P-wave arrival time was not picked at this station, the output is “NoData”.
8 読み取ったS波の観測走時[s]。 pickファイルには適当な「基準時刻」からの経過時間が書かれているが、 これを発震時からの経過時間に換算する。 この観測点でS波を読み取っていない場合はNoDataと出力される。
The observed (picked) S-wave traveltime [s], converted from the original data in the pick file (elapsed time from some “reference time”) to the elapsed time from the earthquake origin time. If the S-wave arrival time was not picked at this station, the output is “NoData”.
9 読み取ったS波の観測走時(観測点補正後)[s]。 pickファイルには適当な「基準時刻」からの経過時間が書かれているが、 これを発震時からの経過時間に換算する。 この観測点でS波を読み取っていない場合はNoDataと出力される。
The observed (picked) S-wave traveltime after the station correction [s], converted from the original data in the pick file (elapsed time from some “reference time”) to the elapsed time from the earthquake origin time. If the S-wave arrival time was not picked at this station, the output is “NoData”.
10 S波の理論走時[s]。 これも発震時からの経過時間で定義する。 この観測点でS波を読み取っていない場合はNoDataと出力される。
The theoretical S-wave travel time [s], defined as the elapsed time from the earthquake origin time. If the S-wave arrival time was not picked at this station, the output is “NoData”.
11 「#s」の行に書かれているS波の観測走時の読み取り誤差[s]。 この観測点でS波を読み取っていない場合はNoDataと出力される。
The picking error of the observed S-wave traveltime [s], written in the “#s” lines. If the S-wave arrival time was not picked at this station, the output is “NoData”.
12 「#f」の行に書かれているS波時刻の精度[s]。 正確な定義は不明だが読み取り誤差とは異なり、 遠方ほど大きくなる傾向にある。 この観測点でS波を読み取っていない場合はNoDataと出力される。
The accuracy [s] of the S-wave arrival time written in the “#f” lines. The exact definition is not clear, but this value is different from the picking error and tends to be larger at greater distances. If the S-wave arrival time was not picked at this station, the output is “NoData”.
13 振動継続時間の観測(読み取り)値すなわちF-P時間[s]。 この観測点でF-P時間を読み取っていない場合はNoDataと出力される。
The observed (picked) duration (F-P time) [s] of the earthquake signal. If the F-P time was not picked at this station, the output is “NoData”.
14 最大振幅[m/s]。 この観測点で最大振幅を読み取っていない場合はNoDataと出力される。
The maximum amplitude [m/s]. If the maximum amplitude was not picked at this station, the output is “NoData”.
15 その観測点での振動継続時間あるいは最大振幅から求めたマグニチュード。 この観測点でマグニチュードを決定できない場合はNoDataと出力される。
The magnitude computed from either the duration or the maximum amplitude at that station. If the magnitude is not determined from the data at this station, the output is “NoData”.
16 観測点の緯度[°]。
The latitude [°] of the station.
17 観測点の経度[°]。
The longitude [°] of the station.
18 観測点の\(x\)座標[m]。 パラメータrefN, refEで指定した基準点からの東方向の距離とし、 refN, refEが与えられていない場合はNoDataと出力される。
The \(x\)-coordinate [m] of the station; east from the reference point given by parameters refN and refE. If refN and refE are not given, the output is “NoData”.
19 観測点の\(y\)座標[m]。 パラメータrefN, refEで指定した基準点からの北方向の距離とし、 refN, refEが与えられていない場合はNoDataと出力される。
The \(y\)-coordinate [m] of the station; north from the reference point given by parameters refN and refE. If refN and refE are not given, the output is “NoData”.
20 観測点の標高[m]。
The altitude [m] of the station.
21 WINシステムにより計算された震央距離[m]。
The epicentral distance [m] computed by the WIN system.
22 WINシステムにより計算された震源から観測点への方位[°]。 北から時計回りに計算する。
The azimuth [°] from the hypocenter to the station computed by the WIN system, measured clockwise from the north.
23 WINシステムにより計算された射出角[°]。 下向きを0として定義される。
The emergence angle [°] from downward computed by the WIN system.
24 WINシステムにより計算された入射角[°]。 下向きを0として定義される。
The incident angle [°] from downward computed by the WIN system.


◆使用例(Example)

summarize_win_hypo /dat/picks/man/2301/230102.030405.678 230102.030405.678.reformatted.dat --refN=35.892778 --refE=137.480278