関数TF_calculate_radiation_pattern マニュアル

(The documentation of function TF_calculate_radiation_pattern)

Last Update: 2022/3/31


◆機能・用途(Purpose)

特定の1つの変位成分、ソース成分、項の組合せについて放射パターンを計算する。
Compute the radiation pattern for the given combination of a displacement component, a source component, and a term.


◆形式(Format)

#include "WIHM_sub/radiation.h"
inline double TF_calculate_radiation_pattern
(const double rho,const double alpha,const double beta,
 const double ∗gamma,const int n,const int p,const int q,
 const char mechanism,const char ∗term)


◆引数(Arguments)

rho 媒質の密度ρ [kg/m3]。
The density, ρ [kg/m3], of the medium.
alpha 媒質のP波速度α [m/s]。
The P-wave velocity, α [m/s], of the medium.
beta 媒質のS波速度β [m/s]。
The S-wave velocity, β [m/s], of the medium.
gamma ソースから観測点に向かう単位方向ベクトルγ の成分を並べた配列。
An array composed of the unit directional vector, γ, from the source to the station.
n 計算したい変位成分の番号n [1-3]。
The displace component, n, to compute [1-3].
p 使用するシングルフォース成分の番号または モーメントテンソル成分の1つ目の番号(力の方向) [1-3]。
The component of the single force to use or the first index (force direction) of the component of the moment tensor to use [1-3].
q 使用するモーメントテンソル成分の2つ目の番号(腕の方向) [1-3]。 シングルフォースソースの場合には用いられないので適当な値を与えれば良い。
The second index (arm direction) of the component of the moment tensor to use [1-3]. In case of a single force source, this argument is not used and thus can be given arbitrarily.
mechanism 以下のいずれかを指定する。
Choose one of the followings.

  • ’F’
    シングルフォース成分が作る放射パターンを計算する。
    Compute the radiation pattern created by a single force component.

  • ’M’
    モーメントテンソル成分が作る放射パターンを計算する。
    Compute the radiation pattern created by a moment tensor component.
term 以下のいずれかを指定する。
Choose one of the followings.

  • "N"
    近地項の放射パターンを計算する。
    Compute the radiation pattern of a near-field term.

  • "IP"
    中間P波項の放射パターンを計算する。
    Compute the radiation pattern of an intermediate-field P-wave term.

  • "IS"
    中間S波項の放射パターンを計算する。
    Compute the radiation pattern of an intermediate-field S-wave term.

  • "FP"
    遠地P波項の放射パターンを計算する。
    Compute the radiation pattern of a far-field P-wave term.

  • "FS"
    遠地S波項の放射パターンを計算する。
    Compute the radiation pattern of a far-field S-wave term.


◆戻り値(Return value)

シングルフォース成分Fpまたは モーメントテンソル成分Mpqによって生じる、 変位成分unの引数termで指定された項の放射パターン。 計算式に基づき、 時間tや距離rに依存する部分を除いた係数部分を計算する。 例えばシングルフォースの近地項であれば (3γnγpδnp)/(4πρ)となる。
The radiation pattern of the term specified by argument term for a displacement component un, caused by a single force component Fp or a moment tensor component Mpq. The radiation pattern is defined as the constant part of each term that does not depend on time t and distance r and computed based on the formula. For example, the return value is (3γnγpδnp)/(4πρ) for the near-field term of a single force source.