momentTensorTimeFunc2eigenコマンドマニュアル

(The documentation of momentTensorTimeFunc2eigen command)

Last Update: 2023/2/16

◆機能・用途(Purpose)

モーメントテンソル6成分の震源時間関数を与えて固有値と固有ベクトルを求める。
Compute the eigenvalues and eigenvectors given the source time functions of six moment tensor components.

このプログラムでは点ソースを仮定した波形インバージョンによりモーメントテンソル6成分の震源時間関数 $M_{xx}(t)$, $M_{yy}(t)$, $M_{zz}(t)$, $M_{xy}(t)$, $M_{yz}(t)$, $M_{zx}(t)$ が得られていることを仮定する。これらを用いて各時刻での固有値・固有ベクトルを求める。
This program assumes that the source time functions of the six moment tensor components of a point source ($M_{xx}(t)$, $M_{yy}(t)$, $M_{zz}(t)$, $M_{xy}(t)$, $M_{yz}(t)$, and $M_{zx}(t)$) are available. This program computes the eigenvalues and eigenvectors at each time sample from these time functions.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/winv/src/momentTensorTimeFunc2eigen.c

◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

引数 Argument	与える値 Quantity to be given
第1引数 1st argument	モーメントテンソル6成分の震源時間関数が格納されているディレクトリ名。 The name of the directory in which the source time functions of the six moment tensor components are stored.
第2引数 2nd argument	出力ファイル名。拡張子は何でも良い。 The output file name. There is no rule for the extension.

●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。「-」から始まらない引数の間に挿入しても良い。相反する指定がなされた場合には後の指定が優先される。デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.

パラメータ名 Parameter name	意味 Meaning	可能なパラメータ値 Allowed parameter values	デフォルト値 Default value
Mxx_file	$M_{xx}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{xx}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Mxx.seq1
Myy_file	$M_{yy}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{yy}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Myy.seq1
Mzz_file	$M_{zz}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{zz}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Mzz.seq1
Mxy_file	$M_{xy}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{xy}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Mxy.seq1
Myz_file	$M_{yz}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{yz}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Myz.seq1
Mzx_file	$M_{zx}(t)$の震源時間関数のファイル名。 The name of the file for the source time function of $M_{zx}(t)$.	ファイル名を表す文字列。第1引数で指定したディレクトリからの相対パスで与える。拡張子は ymaeda_opentools独自の時系列データファイル形式のいずれかでなければならない。 A string that represents a file name, given as a relative path from the directory specified by the 1st argument. The extension must be one of the special file formats of ymaeda_opentools for time series data.	Mzx.seq1
refValue_t	震源時間関数に含まれるオフセットの評価に使用する時刻$t_0$。このパラメータを指定した場合には固有値・固有ベクトルの計算に $M_{ij}(t)$の代わりに$M_{ij}(t)-M_{ij}(t_0)$が用いられる ($i,j=x,y,z$)。 The time $t_0$ used for evaluation of the offset in the source time function. When this parameter is specified, the eigenvalues and eigenvectors are computed from $M_{ij}(t)-M_{ij}(t_0)$ instead of $M_{ij}(t)$, where $i,j=x,y,z$.	震源時間関数の時刻サンプルのいずれかに一致する実数。 A real number identical to one of the time samples of the source time functions.	省略時は$M_{ij}(t)$を用いて固有値・固有ベクトルの計算が行われる。 The eigenvalues and eigenvectors are based on $M_{ij}(t)$ when this parameter is omitted.

◆動作(Behaviour)

第1引数で指定したディレクトリ内のパラメータMxx_file, Myy_file, Mzz_file, Mxy_file, Myz_file, Mzx_file で指定したファイルから $M_{xx}(t)$, $M_{yy}(t)$, $M_{zz}(t)$, $M_{xy}(t)$, $M_{yz}(t)$, $M_{zx}(t)$ の震源時間関数を読み込み、各時刻での固有値と固有ベクトルを計算して第2引数で指定したファイルに出力する。出力ファイルのフォーマットは以下の通りであり、列の区切りにはタブが用いられる。
The source time functions for $M_{xx}(t)$, $M_{yy}(t)$, $M_{zz}(t)$, $M_{xy}(t)$, $M_{yz}(t)$, and $M_{zx}(t)$ are read from the files specified by parameters Mxx_file, Myy_file, Mzz_file, Mxy_file, Myz_file, and Mzx_file, respectively, under the directory specified by the 1st argument. The eigenvalues and eigenvectors at each time sample are computed and written into the file specified by the 2nd argument. The output file format is as below, where tabs are used to separate the columns.

列 Column	値 Value
1	時刻(s)。 Time (s).
2	1つ目の固有値。 The 1st eigenvalue.
3	2つ目の固有値。 The 2nd eigenvalue.
4	3つ目の固有値。 The 3rd eigenvalue.
5	1つ目の固有値に対応する固有ベクトル($x$成分)。 The $x$-component of the eigenvector corresponding to the 1st eigenvalue.
6	1つ目の固有値に対応する固有ベクトル($y$成分)。 The $y$-component of the eigenvector corresponding to the 1st eigenvalue.
7	1つ目の固有値に対応する固有ベクトル($z$成分)。 The $z$-component of the eigenvector corresponding to the 1st eigenvalue.
8	2つ目の固有値に対応する固有ベクトル($x$成分)。 The $x$-component of the eigenvector corresponding to the 2nd eigenvalue.
9	2つ目の固有値に対応する固有ベクトル($y$成分)。 The $y$-component of the eigenvector corresponding to the 2nd eigenvalue.
10	2つ目の固有値に対応する固有ベクトル($z$成分)。 The $z$-component of the eigenvector corresponding to the 2nd eigenvalue.
11	3つ目の固有値に対応する固有ベクトル($x$成分)。 The $x$-component of the eigenvector corresponding to the 3rd eigenvalue.
12	3つ目の固有値に対応する固有ベクトル($y$成分)。 The $y$-component of the eigenvector corresponding to the 3rd eigenvalue.
13	3つ目の固有値に対応する固有ベクトル($z$成分)。 The $z$-component of the eigenvector corresponding to the 3rd eigenvalue.

◆使用例(Example)

momentTensorTimeFunc2eigen source eigen.dat --refValue_t=0.0

◆補足(Additional remarks)

震源時間関数の定義域、サンプル時刻、サンプル間隔はモーメントテンソル6成分で共通でなければならない。共通でない場合はプログラムはエラー終了となる。
The definition ranges, sample times and intervals must be same among the six moment tensor components. If this requirement is not satisfied, the program finishes as an error.

momentTensorTimeFunc2eigenコマンド マニュアル