関数TF_xxi2rgamma マニュアル

(The documentation of function TF_xxi2rgamma)

Last Update: 2022/3/31


◆機能・用途(Purpose)

ソース位置\(\posxi\)と観測点位置\(\posx\)を与えて ソースから観測点までの距離\(r\)と 単位方向ベクトル\(\myvector{\gamma}\)を計算する。
Compute the distance, \(r\), and the unit directional vector, \(\gamma\), from the source to the station using the source location \(\posxi\) and the station location \(\posx\).


◆形式(Format)

#include "WIHM_sub/geometry.h"
inline double TF_xxi2rgamma (const double ∗x,const double ∗xi,double ∗gamma)


◆引数(Arguments)

xi ソース位置\(\posxi=(\xi_1,\xi_2,\xi_3)\) [m]の値を並べた配列。 xi[0]\(=\xi_1\)、xi[1]\(=\xi_2\)、xi[2]\(=\xi_3\)である。
An array composed of the values of source location \(\posxi=(\xi_1,\xi_2,\xi_3)\) [m]; xi[0]\(=\xi_1\), xi[1]\(=\xi_2\), and xi[2]\(=\xi_3\).
x 観測点座標\(\posx=(x_1,x_2,x_3)\) [m]の値を並べた配列。 x[0]\(=x_1\)、x[1]\(=x_2\)、x[2]\(=x_3\)である。
An array composed of the values of station location \(\posx=(x_1,x_2,x_3)\) [m]; x[0]\(=x_1\), x[1]\(=x_2\), and x[2]\(=x_3\).
gamma ソースから観測点への単位方向ベクトル \(\myvector{\gamma}=(\gamma_1,\gamma_2,\gamma_3)\) の代入先。 3要素から成る値を未設定の配列を与える。 関数内で値が設定され、 gamma[0]\(=\gamma_1\)、 gamma[1]\(=\gamma_2\)、 gamma[2]\(=\gamma_3\)となる。
Memory into which the unit directional vector from the source to the station, \(\myvector{\gamma}=(\gamma_1,\gamma_2,\gamma_3)\), is to be inserted. Given an array of 3 components without setting the values. Within the function, the values are set such that gamma[0]\(=\gamma_1\), gamma[1]\(=\gamma_2\), and gamma[2]\(=\gamma_3\).


◆戻り値(Return value)

ソースと観測点の間の距離\(r\) [m]。
The distance, \(r\) [m], from the source to the station.