FF525 ポスト処理関数-ポイントプローブ
 
 ◆ 概要 ◆

FieldView固有の機能へのアクセスを提供するポスト処理関数について説明します。ここでは、ポスト処理関数のうち、ポイントプローブを行う関数について説明します。
※関数の入力引数としてリストされたテーブルの値は、必ずしも必要ではありません。 ほとんどの場合、入力にフィールドが指定されていない場合、そのフィールドのデフォルト値が使用されます。

 ◆ 詳細 ◆
 

クエリ(照会)

probe_current_functions(point [, dataset_number])
この関数は指定したデータセットの特定のポイントにおける関数値を返します。入力引数はテーブルpointとdataset_number(オプション)です。dataset_numberが指定されていない場合、デフォルトはカレントのデータセットになります。出力はテーブルprobe_cf_resultです。 座標系はデカルト座標と円柱座標のどちらにも対応します。

point
インデックス値1、2、3を持つ数値テーブルです。
入力フィールド データ型 コメント デフォルト値
[1] number ‘x’ または ‘r’ 座標  
[2] number ‘y’ または ‘theta’ 座標  
[3] number ‘z’ 座標  
point_cf_result
このテーブルは関数probe_current_functions()によって返されます。
入力フィールド データ型 コメント デフォルト値
point table プロービングされるポイントの番号のテーブル  
region number ポイントが属するリージョン(リージョンが定義されている場合のみ)  
grid number ポイントが属するグリッド番号  
IJK table I、J、K値のテーブル(グリッドタイプが‘structured’の場合のみ存在)  
scalar table スカラー関数の情報を含むテーブル  
func string スカラー関数の名前(関数がない場合はnil)  
value number スカラー関数の値(関数がない場合はnil)  
iso table 等値面関数の情報を含むテーブル  
func string 等値面関数の名前(関数がない場合はnil)  
value number 等値面関数の値(関数がない場合はnil)  
threshold table スレッショルド関数の情報を含むテーブル  
func string スレッショルド関数の名前(関数がない場合はnil)  
value number スレッショルド関数の値(関数がない場合はnil)  
vector table ベクトル関数の情報を含むテーブル  
func string ベクトル関数の名前(関数がない場合はnil)  
value table ベクトル関数のx、y、z成分のテーブル(関数がない場合はnil)  
1 number ベクトル成分の値  
2 number ベクトル成分の値  
3 number ベクトル成分の値  

例:

point = {10, 15, 32}
probe_current_functions(point) -- without specifying dataset
probe_current_functions(point, 3) -- with dataset specified

probe_IJK_current_functions(probe_IJK_input, grid_number [, dataset_number])
これは構造格子にのみ適用可能な関数です。指定したI/J/K値での関数値を返します。最初の入力引数はテーブルprobe_IJK_inputです。2番目の入力引数はgrid_numberです。オプションの第3引数はdataset_numberです。dataset_numberが指定されていない場合、デフォルトはカレントのデータセットになります。出力はテーブルprobe_IJK_resultです。

probe_IJK_input
このテーブルは関数probe_IJK_current_functions()の入力引数です。
入力フィールド データ型 コメント デフォルト値
I number
または
table
   
min number Iのデータ型がテーブルの場合、このフィールドが存在  
max number Iのデータ型がテーブルの場合、このフィールドが存在  
J number
または
table
   
min number Jのデータ型がテーブルの場合、このフィールドが存在  
max number Jのデータ型がテーブルの場合、このフィールドが存在  
K number
または
table
   
min number Kのデータ型がテーブルの場合、このフィールドが存在  
max number Kのデータ型がテーブルの場合、このフィールドが存在  
point_IJK_result
このテーブルは関数probe_IJK_current_functions()によって返されます。
入力フィールド データ型 コメント デフォルト値
n number 返される結果の数  
[n] table n番目の結果の値のテーブル  
IJK table I、J、K値のテーブル(グリッドが‘structured’タイプの場合にのみ存在)  
[1] number インデックスIの値  
[2] number インデックスJの値  
[3] number インデックスKの値  
point table ポイント‘n’のx、y、z座標のテーブル  
[1] number ポイント'n'のx座標の値  
[2] number ポイント'n'のy座標の値  
[3] number ポイント'n'のz座標の値  
grid number ポイントが属するグリッド番号  
region number ポイントが属するリージョン(リージョンが定義されている場合のみ)  
scalar table ポイント‘n’のスカラー関数値  
func string スカラー関数の名前(関数がない場合はnil)  
value number スカラー関数の値(関数がない場合はnil)  
iso table ポイント‘n’の等値面関数値  
func string 等値面関数の名前(関数がない場合はnil)  
value number 等値面関数の値(関数がない場合はnil)  
threshold table ポイント‘n’のスレッショルド関数値  
func string スレッショルド関数の名前(関数がない場合はnil)  
value number スレッショルド関数の値(関数がない場合はnil)  
vector table ポイント‘n’のベクトル関数値  
func string ベクトル関数の名前(関数がない場合はnil)  
value table ベクトル関数のx、y、z成分のテーブル(関数がない場合はnil)  
[1] number ベクトル成分の値  
[2] number ベクトル成分の値  
[3] number ベクトル成分の値  

例:

probe_IJK_input = {
  I=10,
  J=10,
  K=14
}
-– call function with dataset no. specified
probe_IJK_result = probe_IJK_current_functions(probe_IJK_input, 1, 2)

-- print scalar function name
-- Note: Although we have just one table, we still need to
-- specify its number, [1].
print(probe_IJK_result[1].scalar.func)

-- print scalar function value
print(probe_IJK_result[1].scalar.value)

例:

probe_IJK_input = {
  I = 10,
  J = 10,
  K = {
    min=10,
    max=14
  }
}
-– function is called with dataset not specified. Also,
-- more points are returned since a range of K values is
-- provided as input
probe_IJK_result = probe_IJK_current_functions(probe_IJK_input, 1)

–- dump all five tables (for K=10,11,12,13,14)
dumpall(probe_IJK_result)

-– print vector function name for the second table (for K=11)
print(probe_IJK_result[2].vector.func)

--print the value of third component of the vector function
--for the second table (for K=11)
print(probe_IJK_result[2].vector.value[3])

probe_IJK_current_scalar(probe_IJK_scalar_input, grid_number [, dataset_number])
この関数はprobe_IJK_current_functions()と同様のものですが、リージョン、等値面、スレッショルド、ベクトルの値は返さないためパフォーマンスが優れています。

probe_IJK_scalar_input
このテーブルは関数probe_IJK_current_scalar()の入力引数です。
入力フィールド データ型 コメント デフォルト値
I number
または
table
   
min number Iのデータ型がテーブルの場合、このフィールドが存在  
max number Iのデータ型がテーブルの場合、このフィールドが存在  
J number
または
table
   
min number Jのデータ型がテーブルの場合、このフィールドが存在  
max number Jのデータ型がテーブルの場合、このフィールドが存在  
K number
または
table
   
min number Kのデータ型がテーブルの場合、このフィールドが存在  
max number Kのデータ型がテーブルの場合、このフィールドが存在  
point_IJK_scalar_result
このテーブルは関数probe_IJK_current_scalar()によって返されます。
入力フィールド データ型 コメント デフォルト値
n number 返される結果の数  
[n] table n番目の結果の値のテーブル  
IJK table I、J、K値のテーブル(グリッドが‘structured’タイプの場合にのみ存在)  
[1] number インデックスIの値  
[2] number インデックスJの値  
[3] number インデックスKの値  
point table ポイント‘n’のx、y、z座標のテーブル  
[1] number ポイント'n'のx座標の値  
[2] number ポイント'n'のy座標の値  
[3] number ポイント'n'のz座標の値  
grid number ポイントが属するグリッド番号  
region number ポイントが属するリージョン(リージョンが定義されている場合のみ)  
scalar table ポイント‘n’のスカラー関数値  
func string スカラー関数の名前(関数がない場合はnil)  
value number スカラー関数の値(関数がない場合はnil)  
・この資料の内容は予告なしに変更されることがあります。
・いかなる場合でも、この資料の内容およびその運用の結果に関しては一切の責任を負いません。
・この資料の一部または全部を無断で使用、作成することはできません。
All rights reserved by Vinas Co., Ltd.
sales@vinas.com