関数tws_read_source マニュアル

(The documentation of function tws_read_source)

Last Update: 2022/2/24


◆機能・用途(Purpose)

地震波動ソースの設定ファイルを読み込んで struct tws_source型構造体に保存する。 関数tws_set_sourceからの内部呼び出し用の関数である。
Read a configuration file for seismic wave sources and store the results into a struct tws_source-type structure. This function is for an internal call from function tws_set_source.


◆形式(Format)

#include <tws/source.h>
inline void tws_read_source
(const char ∗source_file,void ∗parameters, const char ∗type_material,
 struct tws_source ∗source)


◆引数(Arguments)

source_file 読み込む地震波動ソースの設定ファイル名。
The name of the configuration file for seismic wave sources to read.
parameters waterPMLコマンドから呼び出す場合は パラメータ一式を保存しているstruct waterPML_parameters型構造体のアドレス。 構造体のメンバuse_reciprocityの値が関数内で設定される (相反定理を用いる場合はtrue、用いない場合はfalseになる)。 その他のコマンドから呼び出す場合はNULL。
The address of the struct waterPML_parameters-type structure that keeps the parameters if this function is called from waterPML command. In this case, the member use_reciprocity of the structure is set as true if the reciprocity theorem is used, and false otherwise. NULL if this function is called from the other commands.
type waterPMLコマンド内から呼び出す場合は 格子点の媒質の種類を表す配列(type[is_material])。 その他のコマンドから呼び出す場合はNULL。
An array which represents the types of materials of grid nodes (type[is_material]) if this function is called from waterPML command; NULL otherwise.
source 動的メモリの確保とデフォルト値の設定を行った struct tws_source型構造体の配列を渡す。 関数内でファイルから読み込んだ設定が代入される。
Give an array of struct tws_source-type structures for which the dynamic memory was allocated and default values were set. Within the function, the values are replaced with the configurations read from the file.


◆使用例(Example)

struct waterPML_parameters parameters;
char ∗∗type;
struct tws_source source;
tws_read_source("source.ini",&parameters,type,source);