wartości globalne
Wartości globalne służą do obliczania różnych statystyk podsumowujących dla określonych zmiennych. Dostęp do tych wartości podsumowania można uzyskać w dowolnym miejscu w obrębie przepływu. Wartości globalne są podobne do parametrów przepływu w tym, że dostęp do nich uzyskuje się poprzez nazwę przepływu. Różnią się one od parametrów przepływu, ponieważ powiązane z nimi wartości są aktualizowane automatycznie, gdy uruchamiany jest węzeł Ustaw globalnie, a nie są przypisywane za pomocą skryptów. Dostęp do wartości globalnych dla przepływu można uzyskać, wywołując metodę getGlobalValues() przepływu.
Obiekt GlobalValues definiuje funkcje, które są wyświetlane w poniższej tabeli.
| Metoda | Typ wartości zwracanej | Opis |
|---|---|---|
g.fieldNameIterator() |
Iterator | Zwraca iterator z nazwami zmiennych zawierających co najmniej jedną wartość globalną. |
g.getValue(type, fieldName) |
Obiekt | Zwraca wartość globalną na podstawie określonego typu i nazwy zmiennej albo None, jeśli nie uda się znaleźć wartości. Zasadniczo oczekuje się, że zwrócona wartość będzie liczbą, jednak w przyszłości może pojawić się możliwość zwracania wartości innego typu. |
g.getValues(fieldName) |
Mapa | Zwraca mapę zawierającą znane wpisy dla określonej nazwy zmiennej albo None, jeśli brak jest wpisów dla zmiennej. |
GlobalValues.Type definiuje typ dostępnych statystyk podsumowujących. Dostępne są następujące statystyki podsumowujące:
MAX: maksymalna wartość zmiennej.MEAN: średnia wartość zmiennej.MIN: minimalna wartość zmiennej.STDDEV: odchylenie standardowe zmiennej.SUM: suma wartości zmiennej.
Poniższy skrypt przykładowy odczytuje wartość średnią zmiennej "income", która jest obliczana przez węzeł Globalne.
import modeler.api
globals = modeler.script.stream().getGlobalValues()
mean_income = globals.getValue(modeler.api.GlobalValues.Type.MEAN, "income")