グローバルな価値観
グローバル値は、指定されたフィールドのさまざまな要約統計量を計算するために使用されます。 これらの要約値は、フロー内のどこからでもアクセスできます。 グローバル値は、フローパラメータと同様に、フローを通じて名前でアクセスされます。 フローパラメータとは異なり、関連する値はスクリプトによって割り当てられるのではなく、グローバル設定ノードが実行されると自動的に更新されます。 フローのグローバル値は、フローの getGlobalValues() メソッドを呼び出すことでアクセスできます。
GlobalValues オブジェクトは、以下の表に示す機能を定義します。
| メソッド | 戻りの型 | 説明 |
|---|---|---|
g.fieldNameIterator() |
反復子 | グローバル値が少なくとも1つある各フィールド名のイテレータを返します。 |
g.getValue(type, fieldName) |
オブジェクト | 指定されたタイプとフィールド名のグローバル値を返します。値が見つからない場合は、 None を返します。 返される値は通常、数値であることが期待されますが、将来的な機能では異なる値の型が返される可能性もあります。 |
g.getValues(fieldName) |
マップ | 指定されたフィールド名の既知のエントリを含むマップを返します。または、そのフィールドに既存のエントリがない場合は None を返します。 |
GlobalValues.Type 利用可能な要約統計の種類を定義します。 以下の概要統計が利用可能です
MAX：フィールドの最大値。MEAN：そのフィールドの平均値。MIN：フィールドの最小値。STDDEV：その分野の標準偏差。SUM：フィールド内の値の合計。
例えば、次のスクリプトは「収入」フィールドの平均値にアクセスします。これは、グローバル設定ノードによって計算されます
import modeler.api
globals = modeler.script.stream().getGlobalValues()
mean_income = globals.getValue(modeler.api.GlobalValues.Type.MEAN, "income")