関数tws_set_MandFandT_single_force マニュアル

(The documentation of function tws_set_MandFandT_single_force)

Last Update: 2021/12/8


◆機能・用途(Purpose)

大きさと向きで与えられた地震波動ソースを 直交座標に沿った行列成分表記に変換する。 シングルフォースのメカニズム用。
Convert the mechanism of a seismic wave source, given by the magnitude and orientation, to matrix representations based on a cartesian coordinate, for a single force source mechanism.


◆形式(Format)

#include <tws/source.h>
inline void tws_set_MandFandT_single_force
(const double intensity,const double theta,const double phi,
 struct matrix ∗M,struct columnvector ∗F, struct columnvector ∗T)


◆引数(Arguments)

intensity シングルフォースの大きさ。
The magnitude of the single force.
theta シングルフォースの方向と\(z\)軸のなす角(rad)。
Angle (rad) between the single force direction and the \(z\)-axis.
phi シングルフォースの\(xy\)平面への投影と\(x\)軸のなす角 (rad単位、反時計回り)。
Angle (rad) between projection of the single force on the \(x\)-\(y\) plane and the \(x\)-axis, measured counterclockwise.
M 計算したモーメントテンソル成分から成る行列の代入先。 宣言しただけの構造体を渡す。 関数内で\(3\times 3\)行列として動的メモリの確保と値の設定が行われる。 モーメントテンソル成分\(M_{ij}\)が (∗M).main[i][j]に代入される。 ここで\(i,j=0,1,2\)はそれぞれ\(x\), \(y\), \(z\)成分を表す。
A memory into which a matrix composed of the moment tensor components is inserted. Give a structure which is only declared (without setting the values). In the function, the dynamic memories for a \(3\times 3\) is allocated and the values are set. Each moment tensor component \(M_{ij}\) is inserted into (∗M).main[i][j]. Here, \(i,j=\) 0, 1, and 2 represent \(x\)-, \(y\)-, and \(z\)-components, respectively.
F 計算したシングルフォース成分から成る行列の代入先。 宣言しただけの構造体を渡す。 関数内で3成分の列ベクトルとして動的メモリの確保と値の設定が行われる。 シングルフォース成分\(F_i\)が (∗F).main[i]に代入される。 ここで\(i=0,1,2\)はそれぞれ\(x\), \(y\), \(z\)成分を表す。
A memory into which a matrix composed of the single force components is inserted. Give a structure which is only declared (without setting the values). In the function, the dynamic memories for a 3-component column vector is allocated and the values are set. Each single force component \(F_i\) is inserted into (∗F).main[i]. Here, \(i=\) 0, 1, and 2 represent \(x\)-, \(y\)-, and \(z\)-components, respectively.
T 傾斜変動を相反定理を用いて計算するために観測点の位置に置く 仮想的なソース成分 ( 利用できるメカニズム一覧のtilt, tilt2の説明参照) から成る行列の代入先。 宣言しただけの構造体を渡す。 関数内で6成分の列ベクトルとして動的メモリの確保と値の設定が行われる。 水管傾斜計用の仮想ソースの3成分\(T_i\)が(∗T).main[i]に、 ボアホール型傾斜計用の仮想ソースの3成分\(T_{2i}\)が (∗T).main[i+3]に代入される。 ここで\(i=0,1,2\)はそれぞれ\(x\), \(y\), \(z\)成分を表す。
A memory into which a matrix composed of virtual source components, exerted at the station location to compute tilt based on the reciprocity theorem (see the descriptions for tilt and tilt2 in List of mechanisms available), is inserted. Give a structure which is only declared (without setting the values). In the function, the dynamic memories for a 6-component column vector is allocated and the values are set. The three components of the virtual source for a water tube tiltmeter (\(T_i\)) are inserted into (∗T).main[i], and that for a borehole tiltmeter (\(T_{2i}\)) are inserted into (∗T).main[i+3]. Here, \(i=\) 0, 1, and 2 represent \(x\)-, \(y\)-, and \(z\)-components, respectively.


◆使用例(Example)

double Famp=1.0e+10;
double theta=30.0∗pi/180.0;
double phi=60.0∗pi/180.0;
struct matrix M;
struct columnvector F;
struct columnvector T;
tws_set_MandFandT_single_force(Famp,theta,phi,&M,&F,&T);


◆代入される値(Values inserted)

以下で\(F\), \(\theta\), \(\phi\)はそれぞれ 引数intenisty, theta, phiの値を表す。
Below, \(F\), \(\theta\), and \(\phi\) represent the values of arguments intensity, theta, and phi, respectively.

代入先
Place to insert
代入先の意味
Meaning of the place to insert
代入される値
The value inserted
(∗)M.main[0][0] \(M_{xx}\) 0.0
(∗)M.main[0][1] \(M_{xy}\) 0.0
(∗)M.main[0][2] \(M_{xz}\) 0.0
(∗)M.main[1][0] \(M_{yx}\) 0.0
(∗)M.main[1][1] \(M_{yy}\) 0.0
(∗)M.main[1][2] \(M_{yz}\) 0.0
(∗)M.main[2][0] \(M_{zx}\) 0.0
(∗)M.main[2][1] \(M_{zy}\) 0.0
(∗)M.main[2][2] \(M_{zz}\) 0.0
(∗)F.main[0] \(F_{x}\) \(F\sin\theta\cos\phi\)
(∗)F.main[1] \(F_{y}\) \(F\sin\theta\sin\phi\)
(∗)F.main[2] \(F_{z}\) \(F\cos\theta\)
(∗)T.main[0] \(T_{x}\) 0.0
(∗)T.main[1] \(T_{y}\) 0.0
(∗)T.main[2] \(T_{z}\) 0.0
(∗)T.main[3] \(T_{2x}\) 0.0
(∗)T.main[4] \(T_{2y}\) 0.0
(∗)T.main[5] \(T_{2z}\) 0.0