sacヘッダファイルパッケージ マニュアル

(The documentation of sac header file package)
Last Update: 2024/7/26


sacヘッダファイルパッケージには Seismic Analysis Code (SAC) 形式のデータの読み書きや処理に用いるヘッダファイルをまとめてある。 SACにも様々なデータ形式があるが 等間隔サンプリングの時系列データのみ対応済みである。
Header files used to read, write, and perform operations for data in Seismic Analysis Code (SAC) format are included in sac header file package. Although SAC has various data formats, the current version of this header file package only supports evenly sampled time series data.
SAC時系列データは多数のヘッダとデータ本体から成る。 そこでSACヘッダ一式を格納するためのunion sacheader型共用体、 それらのヘッダとデータ本体をまとめて格納するためのstruct sac_timeseq型構造体を sac/structure.hにおいて定義している。 またSACヘッダの中には列挙型の値を取るものがあり、 それらを表現するためにsacheader_enumvalueという名前の列挙体タグを sac/grobal.hにおいて定義している。
A SAC time series data is composed of various headers and the data values. To express them, a union sacheader-type union to preserve all the SAC headers, and a struct sac_timeseq-type structure to preserve these headers and the data values, are defined in sac/structure.h. Several SAC headers take enumerated values; to express them, an enumeration tag sacheader_enumvalue is defined in sac/grobal.h.
一般にymaeda_opentoolsのヘッダファイルパッケージ間は独立ではないが、 sacヘッダファイルパッケージは特に sequenceヘッダファイルパッケージに強く依存する。 これはSAC時系列データ本体の取り扱いには sequenceヘッダファイルパッケージをそのまま利用し、 そこにSACデータ特有のヘッダ情報を付加する機能を sacヘッダファイルパッケージで提供する という設計にしているためである。
Although the header file packages of ymaeda_opentools are in general not independent to each other, sac header file package especially significantly depends on sequence header file package. This is because the time series data of SAC is treated directly with sequence header file package, whereas sac header file package focuses on a role of adding SAC-specific header information to the time series data.
sacヘッダファイルパッケージ内のヘッダファイルを以下に示す。 各ヘッダファイルの詳細はリンクをクリックして参照のこと。
Header files in sac header file package are listed below. For details of individual header files, click the links.

◆特殊なヘッダファイル (Special header files)

ヘッダファイル名
Header file name 		機能・用途
Purpose
sac/index.h sacヘッダファイルパッケージ内の 他のヘッダファイル一式をインクルードするためのヘッダファイル。
A header file to include all the other header files in sac header file package.
sac/macro.h sacヘッダファイルパッケージ用のマクロの定義。
Definitions of macros for sac header file package.
sac/grobal.h sacヘッダファイルパッケージ用のグローバル変数の定義。
Definitions of grobal variables for sac header file package.
sac/structure.h sacヘッダファイルパッケージ用の構造体の定義。
Definitions of structures for sac header file package.
sac/prototype.h sacヘッダファイルパッケージ内の関数のプロトタイプ。
Prototypes of functions in sac header file package.

◆通常のヘッダファイル (Normal header files)

ヘッダファイル名
Header file name 		機能・用途
Purpose
sac/check.h SACデータをチェックする関数。
Functions to check a SAC data.
sac/convert.h SACデータを表現するための構造体・共用体と 他のデータ形式との間の変換を行う関数。
Functions to make conversion between structures and unions which represent a SAC data and other data formats.
sac/initialize.h SACデータを表現するための構造体・共用体を初期化する関数。
Functions to initialize structures and unions which represent a SAC data.
sac/operation.h SACデータに対する様々な処理を行う関数。
Functions to conduct various operations for SAC data.
sac/readwrite.h SACデータのファイル入出力や画面出力を行う関数。
Function to read and write SAC data from/to a file and to a display output.