関数calculate_best_semblance マニュアル

(The documentation of function calculate_best_semblance)
Last Update: 2025/8/7


◆機能・用途(Purpose)

センブランスの最大値を与えるスローネスと波の到来方向を求め、 そのときのセンブランス値の時系列データを作成する。
Identify the slowness and back azimuth that maximize the semblance value, and create a time series data composed of these semblance values.

◆形式(Format)

#include <array/stack.h>
inline void calculate_best_semblance
(const struct array_station_info stations,
 const struct sequence ∗data_before, const struct sequence ∗data,
 const struct sequence ∗data_after,
 const double slowness_min,const double slowness_max, const double slowness_inc,
 const double back_azimuth_inc,
 const double window_length,const double tinc,
 struct sequence ∗best_slowness, struct sequence ∗best_back_azimuth,
 struct sequence ∗best_semblance)


◆引数(Arguments)

stations アレイの観測点情報。
The station information of the array.
data_before センブランス計算の対象とするタイムウインドウの直前の時系列データ を各観測点について並べた配列。
An array composed of the time-series data at every station immediately before the time window for the semblance computation.
data センブランス計算の対象とするタイムウインドウの時系列データ を各観測点について並べた配列。
An array composed of the time-series data at every station for the time window for the semblance computation.
data_after センブランス計算の対象とするタイムウインドウの直後の時系列データ を各観測点について並べた配列。
An array composed of the time-series data at every station immediately after the time window for the semblance computation.
slowness_min センブランス計算の際に仮定する波のスローネスの最小値。 時刻の単位は時系列データに、距離の単位は観測点座標に合わせる。
The minimum slowness of the wave assumed in the computation of the semblance. The unit of the time must be same as that of the time-series data, and the unit of the distance must be same as that of the station coordinates.
slowness_max センブランス計算の際に仮定する波のスローネスの最大値。
The maximum slowness of the wave assumed in the computation of the semblance.
slowness_inc センブランス計算の際に仮定する波のスローネスの増分。
The increment of the slowness of the wave assumed in the computation of the semblance.
back_azimuth_inc センブランス計算の際に仮定する波の到来方向(°)の増分。
The increment of the back azimuth (°) of the wave assumed in the computation of the semblance.
window_length 一つのセンブランス値の計算に用いるタイムウインドウ長。
Length of the time window used for the computation of each semblance value.
tinc センブランス値のサンプリング間隔。 引数dataのサンプリング間隔の整数倍かつ 引数dataのウインドウ長の整数分の1でなければならない。
Sampling interval of the semblance values; this must be a multiple of the sampling interval of argument data, and the window length of the data must be dividable by this value.
best_slowness センブランスの最大値を与えるスローネスの時系列の代入先。 宣言しただけの空の構造体を与える。 関数内で値が設定される。
The memory into which the time series of the slowness that gives the maximum semblance is inserted. Give an empty structure, then the values are set in this function.
best_back_azimuth センブランスの最大値を与える波の到来方向の時系列の代入先。 宣言しただけの空の構造体を与える。 関数内で値が設定される。
The memory into which the time series of the back azimuth that gives the maximum semblance is inserted. Give an empty structure, then the values are set in this function.
best_semblance センブランスの最大値の時系列の代入先。 宣言しただけの空の構造体を与える。 関数内で値が設定される。
The memory into which the time series of the maximum semblance is inserted. Pass an empty structure, then the values are set in this function.


◆使用例(Example)

calculate_best_semblance
     (stations,data_before,data,data_after,0.002,0.01,0.002,10.0,5.0,2.0,
      &best_slowness,&best_back_azimuth,&best_semblance);