関数TF_set_parameters マニュアル

(The documentation of function TF_set_parameters)

Last Update: 2025/3/25

◆機能・用途(Purpose)

コマンドライン引数からパラメータを読み込んでチェックを行い、 struct waterPML_parameters型構造体にパラメータの値を保存する。
Read the command-line arguments, check them, and preserve the values of parameters to a struct waterPML_parameters-type structure.

◆形式(Format)

#include "waterPML_sub/set_parameters.h"
inline struct waterPML_parameters TF_set_parameters
(const int ARGC,char ∗const ∗ARGV)

◆引数(Arguments)

ARGC	コマンドライン引数の個数(関数mainの第1引数)。 The number of command-line arguments (the 1st argument of function main).
ARGV	コマンドライン引数のリスト(関数mainの第2引数)。 A list of command-line arguments (the 2nd argument of function main).

◆戻り値(Return value)

メンバの値を以下のように設定した構造体。
A structure whose members were set as below.

メンバ Member	値 Value
N[0]	パラメータNxの値( $N_{x}$ )。 The value of parameter Nx ( $N_{x}$ ).
N[1]	パラメータNyの値( $N_{y}$ )。 The value of parameter Ny ( $N_{y}$ ).
N[2]	パラメータNzの値( $N_{z}$ )。 The value of parameter Nz ( $N_{z}$ ).
Np[0][0]	パラメータNpmxの値( $N_{p m l}^{- x}$ )。 The value of parameter Npmx ( $N_{p m l}^{- x}$ ).
Np[0][1]	パラメータNpmyの値( $N_{p m l}^{- y}$ )。 The value of parameter Npmy ( $N_{p m l}^{- y}$ ).
Np[0][2]	パラメータNpmzの値( $N_{p m l}^{- z}$ )。 The value of parameter Npmz ( $N_{p m l}^{- z}$ ).
Np[1][0]	パラメータNppxの値( $N_{p m l}^{+ x}$ )。 The value of parameter Nppx ( $N_{p m l}^{+ x}$ ).
Np[1][1]	パラメータNppyの値( $N_{p m l}^{+ y}$ )。 The value of parameter Nppy ( $N_{p m l}^{+ y}$ ).
Np[1][2]	パラメータNppzの値( $N_{p m l}^{+ z}$ )。 The value of parameter Nppz ( $N_{p m l}^{+ z}$ ).
NN[0]	$2 (N_{p m l}^{- x} + N_{x} + N_{p m l}^{+ x}) + 1$ で、計算領域内の半格子点の数( $x$ 方向)を表す。 $2 (N_{p m l}^{- x} + N_{x} + N_{p m l}^{+ x}) + 1$ , which represents the number of half-grid nodes ( $x$ -direction) in the computational volume.
NN[1]	$2 (N_{p m l}^{- y} + N_{y} + N_{p m l}^{+ y}) + 1$ で、計算領域内の半格子点の数( $y$ 方向)を表す。 $2 (N_{p m l}^{- y} + N_{y} + N_{p m l}^{+ y}) + 1$ , which represents the number of half-grid nodes ( $y$ -direction) in the computational volume.
NN[2]	$2 (N_{p m l}^{- z} + N_{z} + N_{p m l}^{+ z}) + 1$ で、計算領域内の半格子点の数( $z$ 方向)を表す。 $2 (N_{p m l}^{- z} + N_{z} + N_{p m l}^{+ z}) + 1$ , which represents the number of half-grid nodes ( $z$ -direction) in the computational volume.
x0[0]	パラメータx0の値( $x_{0}$ )。 The value of parameter x0 ( $x_{0}$ ).
x0[1]	パラメータy0の値( $y_{0}$ )。 The value of parameter y0 ( $y_{0}$ ).
x0[2]	パラメータz0の値( $z_{0}$ )。 The value of parameter z0 ( $z_{0}$ ).
dx[0]	パラメータdxの値( $Δ x$ )。 The value of parameter dx ( $Δ x$ ).
dx[1]	パラメータdyの値( $Δ y$ )。 The value of parameter dy ( $Δ y$ ).
dx[2]	パラメータdzの値( $Δ z$ )。 The value of parameter dz ( $Δ z$ ).
dt	パラメータdtの値( $Δ t$ )。 The value of parameter dt ( $Δ t$ ).
tmin	パラメータtminの値( $t_{m i n}$ )。 The value of parameter tmin ( $t_{m i n}$ ).
tmax	パラメータtmaxの値( $t_{m a x}$ )。 The value of parameter tmax ( $t_{m a x}$ ).
itmin	$t_{m i n} / Δ t$ で、時刻 $t_{m i n}$ に対応する時間ステップ番号を表す。 $t_{m i n} / Δ t$ , which represents the time step index corresponding to time $t_{m i n}$ .
itmax	$t_{m a x} / Δ t$ で、時刻 $t_{m a x}$ に対応する時間ステップ番号を表す。 $t_{m a x} / Δ t$ , which represents the time step index corresponding to time $t_{m a x}$ .
PML_A	パラメータPML_Aの値。 The value of parameter PML_A.
PML_n	パラメータPML_nの値。 The value of parameter PML_n.
Ntopo	使用する地形データファイルの個数。パラメータtopography_filesにおけるカンマ(,)の個数 $+ 1$ として計算される。パラメータtopography_filesの省略時は0になる。 The number of topography data files used, calculated as the number of commas (,) in the value of parameter topography_files added by 1. When parameter topography_files was omitted, the value of this member is set to be 0.
topography_files	使用する地形データファイル名のリスト。パラメータtopography_filesの値をカンマ(,)で区切った文字列の配列(char型2次元配列)。パラメータtopography_filesの省略時はこのメンバの値は設定されない。 The list of the names of topography data files used; an array of strings (a char-type 2-D array) created by separating the value of parameter topography_files by commas (,). The value of this member is not set when parameter topography_files was omitted.
topography_file_format	パラメータtopography_file_formatの値。 The value of parameter topography_file_format.
refN	パラメータrefNの値。 The value of parameter refN.
refE	パラメータrefEの値。 The value of parameter refE.
topography_interpolation_method	パラメータtopography_interpolation_methodの値。 The value of parameter topography_interpolation_method.
Nlake	この関数では設定しない。 Not set in this function.
water_file	パラメータwater_fileの値。パラメータwater_fileの省略時は空文字("")となる。 The value of parameter water_file. When this parameter was omitted, an empty string ("") is set.
structure_file	パラメータstructure_fileの値。 The value of parameter structure_file.
structure_file_format	パラメータstructure_file_formatの値。 The value of parameter structure_file_format.
source_file	パラメータsource_fileの値。 The value of parameter source_file.
Nsource	使用する地震波動ソースの個数。パラメータsource_fileで指定した設定ファイルを使用し、関数tws_count_sourceにより設定される。 The number of seismic wave sources to be used, determined by function tws_count_source with the configuration file specified by parameter source_file.
random_seed	パラメータrandom_seedの値。 The value of parameter random_seed.
source_memory	パラメータsource_memoryの値。 The value of parameter source_memory.
use_reciprocity	この関数では設定しない。 Not set in this function.
output_dir	パラメータoutput_dirの値。 The value of parameter output_dir.
station_file	パラメータstation_fileの値。 The value of parameter station_file.
Nstation	この関数では設定しない。 Not set in this function.
output_dt	パラメータoutput_dtの値( $Δ t_{w a v e f o r m}$ )。 The value of parameter output_dt ( $Δ t_{w a v e f o r m}$ ).
output_Nskip	$Δ t_{w a v e f o r m} / Δ t$ で、計算の時間ステップの何ステップに1回波形を出力するかを表す。 $Δ t_{o u t p u t} / Δ t$ , which represents the time interval of waveform output measured as the number of time steps of the computation.
snapshot_grid	パラメータsnapshot_gridの値。但し「specify:file=ファイル名」の場合には「:」から後を除いて単に「specify」とする。 The value of parameter snapshot_grid; however, if the value is “specify:file=file name”, then only the part “specify” is copied to this member skipping the part after “:”.
snapshot_file	パラメータsnapshot_gridの値が「specify:file=ファイル名」の場合にはそのファイル名。それ以外の場合はこのメンバの値は設定されない。 If the value of parameter snapshot_grid is “specify:file=file name”, then the file name is copied to this member. In the other cases, the value of this member is not set.
Nsnapshot	この関数では設定しない。 Not set in this function.
snapshot_place	パラメータsnapshot_placeの値。 The value of parameter snapshot_place.
snapshot_dt	パラメータsnapshot_dtの値( $Δ t_{s n a p s h o t}$ )。 The value of parameter snapshot_dt ( $Δ t_{s n a p s h o t}$ ).
snapshot_Nskip	$Δ t_{s n a p s h o t} / Δ t$ で、計算の時間ステップの何ステップに1回スナップショットを出力するかを表す。 $Δ t_{o u t p u t} / Δ t$ , which represents the time interval of snapshot output measured as the number of time steps of the computation.
output_parameters	パラメータoutput_parametersの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_parameters, converted as yes to true and no to false.
output_stg	パラメータoutput_stgの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_stg, converted as yes to true and no to false.
output_solid_surface	パラメータoutput_solid_surfaceの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_solid_surface, converted as yes to true and no to false.
output_water_surface	パラメータoutput_water_surfaceの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_water_surface, converted as yes to true and no to false.
output_source	パラメータoutput_sourceの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_source, converted as yes to true and no to false.
output_station	パラメータoutput_stationの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_station, converted as yes to true and no to false.
output_topography_around_stations	パラメータoutput_topography_around_stationsの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter output_topography_around_stations, converted as yes to true and no to false.
tilt_output	パラメータtilt_outputの値。 The value of parameter tilt_output.
dimension	パラメータdimensionの値。 The value of parameter dimension.
save_final	パラメータsave_finalの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter save_final, converted as yes to true and no to false.
use_prev	パラメータuse_prevの値。 yesを真(true)に、noを偽(false)に変換する。 The value of parameter use_prev, converted as yes to true and no to false.