関数wintosac_fullAuto マニュアル

(The documentation of function wintosac_fullAuto)

Last Update: 2025/7/11


◆機能・用途(Purpose)

WINファイルから読み込んだWINデータを直接の入力として SAC形式の時系列データに全自動で変換する。
Fully automatically convert unprocessed WIN data from a WIN file to SAC time series data.


◆形式(Format)

#include <win/convert.h>
inline struct sac_timeseq ∗wintosac_fullAuto
(struct win_data winData,const struct win_channelTable channelTable)


◆引数(Arguments)

winData WINファイルから読み込んだWINデータ( 関数read_win_fileの戻り値)を与える。 メンバsecondBlocksの各配列要素は1つの秒ブロックのデータを表す構造体であり、 そのメンバchannelBlockにはチャンネルブロックのデータを並べた配列が格納されている。 この関数内でこの「チャンネルブロックのデータを並べた配列」がソートされる。
Give a WIN data that was read from a WIN file (the return value of function read_win_file). Each array component of its member secondBlocks represents the data for each second block, which is a structure. The member channelBlock of this structure is an array composed of the data of channel blocks. Within this function, this “array composed of the data of channel blocks” is sorted.
channelTable チャンネルテーブルのデータ。 関数win_selectChannelTable の戻り値を与える。
A channel table data given by function win_selectChannelTable.


◆戻り値(Return value)

引数winDataで与えたWINデータをSAC形式に変換した時系列データを並べた配列。 引数channelTableにおけるチャンネルの登場順に並べる。 個々の時系列データにおいて欠損は直線で内挿される。 より厳密な時系列データの構成方法は 関数wintosacのマニュアル参照。
An array composed of the time series data in SAC format, converted from the WIN data given by argument winData, sorted in the order of the channels in argument channelTable. The defects in each time series data are linearly interpolated. See the documentation of function wintosac for more exact description for the construction of the time series data.


◆使用例(Example)

int NsecondBlock =win_countSecondBlock("data.win");

struct win_data winData =read_win_file("data.win");

struct win_channelCodeList channels =win_readChannelCode("channel_codes.txt");

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

struct win_channelTable channelTable_use =win_selectChannelTable(channelTable_all,channels);

sruct sac_timeseq ∗sacdata=wintosac_fullAuto (NsecondBlock, winData, channelTable_use);