tws/structure.h マニュアル

(The documentation of tws/structure.h)
Last Update: 2024/3/7


tws/structure.hでは twsヘッダファイルパッケージで主に用いる構造体が定義されている。 各構造体の定義を以下に示す。
Structures mainly used in tws header file package are defined in tws/structure.h. Definitions of individual structures are shown below.

◆目次(Table of contents)


◆struct tws_source型構造体 (A struct tws_source-type structure)

地震波の理論計算で用いる波動ソースに関する定数をまとめた構造体である。 以下のメンバから成る。
A structure composed of constants that characterize the wave source used in the calculation of synthetic seismic waves. This structure is composed of the following members.
型
Type 		メンバ名
Name of member 		メンバの意味
Meaning of member
char name[strsize] ソースの名前。
Name of the source.
double location[3] ソースの中心位置。 location[0]が\(x\)座標、location[1]が\(y\)座標、 location[2]が\(z\)座標を表す。
The central location of the source; location[0], location[1], and location[2] represent the \(x\)-, \(y\)-, and \(z\)-coordinates, respectively.
unsigned int location_x_specified : 1 ソースの中心位置の\(x\)座標が指定されたか否かを示すフラグ。 指定された場合は1、未指定の場合は0とする。
A flag indicating whether the \(x\)-coordinate of the central location of the source was specified; 1 if specified, 0 if not specified.
unsigned int location_y_specified : 1 ソースの中心位置の\(y\)座標が指定されたか否かを示すフラグ。 指定された場合は1、未指定の場合は0とする。
A flag indicating whether the \(y\)-coordinate of the central location of the source was specified; 1 if specified, 0 if not specified.
unsigned int location_z_specified : 1 ソースの中心位置の\(z\)座標が指定されたか否かを示すフラグ。 指定された場合は1、未指定の場合は0とする。
A flag indicating whether the \(z\)-coordinate of the central location of the source was specified; 1 if specified, 0 if not specified.
char mechanism[strsize] ソースメカニズムを表す文字列。
A string which represents the source mechanism.
double intensity ソースにおける変形量や等価体積力などの強度。 具体的な定義はソースメカニズムによって異なる。
The intensity of the deformation or equivalent body force at the source. The explicit definition depends on the source mechanism.
double theta 軸対称なソースメカニズム(開口クラックや円筒など)における 対称軸と\(z\)軸のなす角。 °単位で指定するが、計算時にはrad単位に換算される。
Angle between \(z\) and the symmetry axes for an axisymmetric source mechanism (e.g., a tensile crack or a cylinder). The value is specified in degree unit, and is converted to radian unit when used in the calculation.
double phi 軸対称なソースメカニズム(開口クラックや円筒など)における 対称軸の\(xy\)平面への投影と\(x\)軸のなす角。 \(x\)軸から反時計回りに測る。 °単位で指定するが、計算時にはrad単位に換算される。
Angle between the \(x\) axis and the projection of the symmetry axis onto the \(xy\) plane for an axisymmetric source mechanism (e.g., a tensile crack or a cylinder). The angle is measured counterclockwise from the \(x\) axis. The value is specified in degree unit, and is converted to radian unit when used in the calculation.
double strike 震源断層の走向。 °単位で指定するが、計算時にはrad単位に換算される。
The strike of the source fault. The value is specified in degree unit, and is converted to radian unit when used in the calculation.
double dip 震源断層の傾斜角。 °単位で指定するが、計算時にはrad単位に換算される。
The dip angle of the source fault. The value is specified in degree unit, and is converted to radian unit when used in the calculation.
double rake 震源断層のrake角。 °単位で指定するが、計算時にはrad単位に換算される。
The rake angle of the source fault. The value is specified in degree unit, and is converted to radian unit when used in the calculation.
double length 震源断層の走向方向に沿った長さ(m)。
Length (m) of the source fault along the strike direction.
double width 震源断層の傾斜方向に沿った幅(m)。
Width (m) of the source fault along the dip direction.
char slip_distribution[strsize] 震源断層におけるすべり量の空間分布の種類を表す文字列。
A string which represents the type of the spatial distribution of the slip on the fault.
char stfun_name[strsize] 震源時間関数の名前。 sequence/timefunc.hでの定義に基づく。
Name of the source time function, based on the definitions in sequence/timefunc.h.
double stfun_tp 震源時間関数の1つ目の時定数\(\tau_p\)(s)。 sequence/timefunc.hでの定義に基づく。
The first time constant \(\tau_p\) (s) of the source time function, based on the definitions in sequence/timefunc.h.
double stfun_ts 震源時間関数の2つ目の時定数\(\tau_s\)(s)。 sequence/timefunc.hでの定義に基づく。
The second time constant \(\tau_s\) (s) of the source time function, based on the definitions in sequence/timefunc.h.

◆struct waterPML_parameters型構造体 (A struct waterPML_parameters-type structure)

waterPMLコマンド(opentwsサブパッケージ)で使用するパラメータ一式を まとめた構造体である。 waterPMLコマンドのソースコードではなくこのヘッダファイルで定義しているのは 依存関係の都合による。 以下のメンバから成る。
A structure composed of parameters used in waterPML command (opentws subpackage). This structure is defined in this header file instead of the source code of waterPML command because of dependency. This structure is composed of the following members.
型
Type 		メンバ名
Name of member 		メンバの意味
Meaning of member
int N[3] パラメータNx,Ny,Nzの値を並べた配列。
An array composed of the values of parameters Nx, Ny, and Nz.
int Np[2][3] パラメータNpmx,Npmy,Npmz,Nppx,Nppy,Nppzの値を並べた配列。
An array composed of the values of parameters Npmx, Npmy, Npmz, Nppx, Nppy, and Nppz.
int NN[3] 計算領域内の\(x\), \(y\), \(z\)方向の半格子点の数を並べた配列。
An array composed of the numbers of half-grid nodes along the \(x\)-, \(y\)-, and \(z\)-directions in the computational volume.
double x0[3] パラメータx0,y0,z0の値を並べた配列。
An array composed of the values of parameters x0, y0, and z0.
double dx[3] パラメータdx,dy,dzの値を並べた配列。
An array composed of the values of parameters dx, dy, and dz.
double dt パラメータdtの値(\(\Delta t\))。
The value of parameter dt (\(\Delta t\)).
double tmin パラメータtminの値(\(t_{min}\))。
The value of parameter tmin (\(t_{min}\)).
double tmax パラメータtmaxの値(\(t_{max}\))。
The value of parameter tmax (\(t_{max}\)).
int itmin \(t_{min}/\Delta t\)の値。 時刻\(t_{max}\)に対応する時間ステップ番号を表す。
The value of \(t_{min}/\Delta t\), which represents the time step index corresponding to time \(t_{min}\).
int itmax \(t_{max}/\Delta t\)の値。 時刻\(t_{max}\)に対応する時間ステップ番号を表す。
The value of \(t_{max}/\Delta t\), which represents the time step index corresponding to time \(t_{max}\).
double PML_A パラメータPML_Aの値。
The value of parameter PML_A.
double PML_n パラメータPML_nの値。
The value of parameter PML_n.
int Ntopo 使用する地形データファイルの個数。
The number of topography data files used.
char ∗∗topography_files 使用する地形データファイル名のリスト。
The list of the names of topography data files used.
char topography_file_format[strsize] パラメータtopography_file_formatの値。
The value of parameter topography_file_format.
char refN[strsize] パラメータrefNの値。
The value of parameter refN.
char refE[strsize] パラメータrefEの値。
The value of parameter refE.
char topography_interpolation_method[strsize] パラメータtopography_interpolation_methodの値。
The value of parameter topography_interpolation_method.
int Nlake 使用する水域の個数。
The number of water-filled regions used.
char water_file[strsize] パラメータwater_fileの値。
The value of parameter water_file.
char structure_file[strsize] パラメータstructure_fileの値。
The value of parameter structure_file.
char structure_file_format[strsize] パラメータstructure_file_formatの値。
The value of parameter structure_file_format.
char source_file[strsize] パラメータsource_fileの値。
The value of parameter source_file.
int Nsource 使用する地震波動ソースの個数。
The number of seismic wave sources to be used.
_Bool use_reciprocity 相反定理を用いるか否かを示すフラグ。
A flag indicating whether the reciprocity theorem is used or not.
char output_dir[strsize] パラメータoutput_dirの値。
The value of parameter output_dir.
char station_file[strsize] パラメータstation_fileの値。
The value of parameter station_file.
int Nstation 使用する観測点の個数。
The number of stations to be used.
double output_dt パラメータoutput_dtの値(\(\Delta t_{waveform}\))。
The value of parameter output_dt (\(\Delta t_{waveform}\)).
int output_Nskip \(\Delta t_{waveform}/\Delta t\)の値。 計算の時間ステップの何ステップに1回波形を出力するかを表す。
The value of \(\Delta t_{waveform}/\Delta t\), which represents the time interval of waveform output measured as the number of time steps of the computation.
char snapshot_grid[strsize] パラメータsnapshot_gridの値。
The value of parameter snapshot_grid.
char snapshot_file[strsize] 使用するスナップショットの設定ファイル名。
The name of the configuration file of the snapshot to be used.
int Nsnapshot 出力するスナップショットの個数。
The number of snapshots to output.
char snapshot_place パラメータsnapshot_placeの値。
The value of parameter snapshot_place.
double snapshot_dt パラメータsnapshot_dtの値(\(\Delta t_{snapshot}\))。
The value of parameter snapshot_dt (\(\Delta t_{snapshot}\)).
int snapshot_Nskip \(\Delta t_{snapshot}/\Delta t\)の値。 計算の時間ステップの何ステップに1回スナップショットを出力するかを表す。
The value of \(\Delta t_{snapshot}/\Delta t\), which represents the time interval of snapshot output measured as the number of time steps of the computation.
_Bool output_parameters パラメータoutput_parametersの値。
The value of parameter output_parameters.
_Bool output_stg パラメータoutput_stgの値。
The value of parameter output_stg.
char tilt_output[strsize] パラメータtilt_outputの値。
The value of parameter tilt_output.
int dimension パラメータdimensionの値。
The value of parameter dimension.
_Bool save_final パラメータsave_finalの値。
The value of parameter save_final.
_Bool use_prev パラメータuse_prevの値。
The value of parameter use_prev.