関数rayParameters_1Dscalar_nocheck.html マニュアル

(The documentation of function rayParameters_1Dscalar_nocheck.html)
Last Update: 2021/12/6


◆機能・用途(Purpose)

与えられた1次元速度構造のもとで2つの地点を結ぶ波線パラメータを推定する (波線パラメータは複数になる場合がある)。 波線パラメータが見つからない場合であってもエラーにしない。
Investigate ray parameters connecting two points using a given 1D velocity structure (there may be multiple ray parameters). No error is issued even if no ray parameter was found.

◆形式(Format)

#include <ray/calculate1Dscalar.h>
inline int rayParameters_1Dscalar_nocheck
(const double x1,const double z1,const double x2,const double z2,
 const struct _1DvelocityStructure structure, double ∗∗pList)


◆引数(Arguments)

x1 計算に用いる一方の地点の水平位置。
The horizontal location of one point used for the calculation.
z1 \(x_1\)に対応する地点の深さ。
The depth of the point corresponding to \(x_1\).
x2 計算に用いる他方の地点の水平位置。
The horizontal location of the other point used for the calculation.
z2 \(x_2\)に対応する地点の深さ。
The depth of the point corresponding to \(x_2\).
structure 1次元速度構造。
A 1D velocity structure.
pList 推定した波線パラメータのリストの代入先。 宣言しただけのdouble ∗型変数を&を付けて与える。 関数内でこの変数が配列となり(動的メモリが確保され)、 その\(n\)番目の配列要素には \((x_1,z_1)\)と\((x_2,z_2)\)を結ぶ \(n\)番目の波線パラメータが代入される。 波線パラメータが見つからなかった場合はNULLとなる。
A memory into which the estimated ray parameter list will be inserted; prepare a double ∗-type variable that is only declared, and give it to this function with ‘&’. In this function, an array will be prepared for this function (by allocating a dynamic memory), and the \(n\)th ray parameter connecting \((x_1,z_1)\) and \((x_2,z_2)\) will be inserted into the \(n\)th component of the array. NULL is set if no ray parameter was found.


◆戻り値(Return value)

\((x_1,z_1)\)と\((x_2,z_2)\)を結ぶ波線パラメータの個数。
The number of ray parameters connecting \((x_1,z_1)\) and \((x_2,z_2)\).

◆使用例(Example)

struct _1DvelocityStructure structure;
double ∗p;
int Np=rayParameters_1Dscalar_nocheck (1000.0,100.0,3000.0,200.0,structure,&p);


◆補足(Additional remarks)

計算方法など詳しくは 関数rayParameters_1Dscalarのマニュアル参照。
For more information including the computation method, see the documentation of function rayParameters_1Dscalar.