Valores globais

Os valores globais são usados para calcular várias estatísticas resumidas para campos especificados. Esses valores resumidos podem ser acessados em qualquer lugar do fluxo. Os valores globais são semelhantes aos parâmetros de fluxo, pois são acessados por nome no fluxo. Eles são diferentes dos parâmetros de fluxo, pois os valores associados são atualizados automaticamente quando um nó Set Globals é executado, em vez de serem atribuídos por script. Os valores globais de um fluxo são acessados chamando o método getGlobalValues() do fluxo.

O objeto GlobalValues define as funções que são mostradas na tabela a seguir.

Tabela 1. Funções que são definidas pelo objeto GlobalValues
Método	Tipo de retorno	Descrição
`g.fieldNameIterator()`	Iterador	Retorna um iterador para cada nome de campo com pelo menos um valor global.
`g.getValue(type, fieldName)`	Objeto	Retorna o valor global para o tipo e o nome de campo especificados ou `None` se nenhum valor puder ser localizado. Em geral, espera-se que o valor retornado seja um número, embora a funcionalidade futura possa retornar tipos de valores diferentes.
`g.getValues(fieldName)`	Mapa	Retorna um mapa contendo as entradas conhecidas para o nome de campo especificado ou `None` se não houver entradas existentes para o campo.

GlobalValues.Type define o tipo de estatísticas resumidas que estão disponíveis. As seguintes estatísticas resumidas estão disponíveis:

MAX: o valor máximo do campo.
MEAN: o valor médio do campo.
MIN: o valor mínimo do campo.
STDDEV: o desvio padrão do campo.
SUM: a soma dos valores no campo.

Por exemplo, o script a seguir acessa o valor médio do campo "income", que é calculado por um nó Set Globals:

import modeler.api

globals = modeler.script.stream().getGlobalValues()
mean_income = globals.getValue(modeler.api.GlobalValues.Type.MEAN, "income")