関数reformat_win_pick マニュアル

(The documentation of function reformat_win_pick)

Last Update: 2025/7/31

◆機能・用途(Purpose)

pickファイルから読み込んだデータを扱いやすいように整形する。
Reformat a pick data to be more easily treatable.

◆形式(Format)

#include <win/pick.h>
inline void reformat_win_pick
(struct win_pick ∗pick_data,
const struct win_channelTable channelTable)

◆引数(Arguments)

pick_data

Nstations, data以外のメンバを設定した構造体に&を付けて与える。関数内でメンバNstations, dataの値が設定される。
Give a structure, whose members other than Nstations and data have been set, with &. Within the function, the values of members Nstations and data are set.

channelTable

チャンネルテーブルのデータ。 pickファイルから読み込んだ「#p」の行に書かれているチャンネルコードと「#s」の行に書かれている観測点コードを関係付けるために用いられる。
A channel table data, used to relate channel codes in the lines beginning with “#p” and station codes in the lines beginning with “#s” of a pick file.

◆動作(Behaviour)

引数pick_dataで与えた構造体のメンバNstations, dataの値を設定する。
Set the values of members Nstations and data of the structure given by argument pick_data.

メンバNstationsにはメンバNdata_sの値がコピーされる。メンバdataの配列要素数もこの値となる。
The value of member Ndata_s is copied to member Nstations. This value is used for the number of array components of member data.
メンバdataにおける配列要素の並び順はメンバdata_sと同じになる。
The order of array components of member data is equivalent to that of member data_s.
メンバdataの配列要素はstruct win_pick_data型構造体である。そのメンバは以下のように設定される。
Each array component of member data is a struct win_pick_data-type structure. The values of its members are determined as follows.
- struct win_pick_data型構造体のメンバ stationCode, Tp_correction, Ts_correctionは引数pick_dataのメンバdata_sに基づいて設定される。
  Members stationCode, Tp_correction, and Ts_correction of a struct win_pick_data-type structure are determined based on member data_s of argument pick_data.
- struct win_pick_data型構造体のメンバ epicentral_distance, station_azimuth, emergence_angle, incident_angleは引数pick_dataのメンバdata_fに基づいて設定される。
  Members epicentral_distance, station_azimuth, emergence_angle, and incident_angle of a struct win_pick_data-type structure are determined based on member data_f of argument pick_data.
- struct win_pick_data型構造体のメンバTp_calc, Ts_calcは引数pick_dataのメンバdata_pから取得したP波・S波到着時刻、メンバdata_sから取得した観測点補正値、メンバdata_fから取得した残差値に基づいて計算される。
  Members Tp_calc and Ts_calc of a struct win_pick_data-type structure are calculated using P- and S-wave arrival times acquired from member data_p, station corrections acquired from member data_s, and residuals acquired from member data_f of argument pick_data.
- struct win_pick_data型構造体の残りのメンバは引数pick_dataのメンバdata_pに基づいて設定される。
  The other members of a struct win_pick_data-type structure are determined based on member data_p of argument pick_data.

◆使用例(Example)

struct win_pick pick_data =read_win_pickfile("./picks/man/2506/250623.012345.012");

struct win_channelTable channelTable =win_readChannelTable("channels.tbl");

reformat_win_pick(&pick_data,channelTable);