機能
入力オブジェクトから指定した値に最も近いデータを見つけ,値とその位置を表示し,位置を Series オブジェクトとして返す.
形式
ip = find( x, val, num )
パラメータ
x : 入力オブジェクト (Series, Snapshot)
ip : データの位置 (Series)
val : 捜し出す値
num : 捜し出すデータの個数
解説
入力オブジェクト内から val に最も近い値を持つインデックスの系列を取得する.
インデックスの系列は,次元数分の要素を持ち,時間方向に num 個得られる.
取得するデータ数が 1 個で,かつ 1 次元データの位置を示す場合には戻り値は,Scalar オブジェクトである.
使用例
1 次元の場合
[0]% 11 12 13 14 15
という x に対し,find(x,14,3) を実行すると,
[0]:[0]% 3
[1]:[0]% 4
[2]:[0]% 2
2 次元の場合
[0]:[0]% 11 12 13 14 15
[1]:[0]% 16 17 18 19 20
という x に対し,find(x,14,3) を実行すると,
[0]:[0]% 0 3
[1]:[0]% 0 4
[2]:[0]% 0 2