wiki:programmersguide/architecture/services/analysis/python/occurrence/aggregation

Version 6 (modified by jano.simas, 9 years ago) (diff)

--

Operadores de agregação de ocorrências

Conjunto de operadores para série de dados do tipo Ocorrência com agregação de ocorrências na mesma área

Contagem

Retorna a quantidade de ocorrências num intervalo de tempo dentre aquelas que interceptam o objeto monitorado ou sua área de influência, se houver sobreposição dos buffers de agregação, as ocorrências serão agrupadas e contadas como uma única ocorrência.

Assinatura

terrama2.occurrence.zonal.aggregation.count("dataSeriesName", "dateFilter", aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.count("ocorrencias", "1d", aggregationBuffer, buffer, "UF = 'AM'")

Mínimo

Retorna o menor valor do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.min("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.min("ocorrencias", "1d", "Intensidade", Statistic.min, aggregationBuffer, buffer, "UF = 'AM'")

Máximo

Retorna o maior valor do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.max("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.max("ocorrencias", "1d", "Intensidade", Statistic.max, aggregationBuffer, buffer, "UF = 'AM'")

Média

Retorna a média dos valores do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.mean("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.mean("ocorrencias", "1d", "Intensidade", Statistic.mean, aggregationBuffer, buffer, "UF = 'AM'")

Soma

Retorna a soma dos valores do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.sum("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.sum("ocorrencias", "1d", "Intensidade", Statistic.max, aggregationBuffer, buffer, "UF = 'AM'")

Mediana

Retorna a mediana dos valores do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.median("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.median("ocorrencias", "1d", "Intensidade", Statistic.median, aggregationBuffer, buffer, "UF = 'AM'")

Desvio Padrão

Retorna o desvio padrão dos valores do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.standard_deviation("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.standard_deviation("ocorrencias", "1d", "Intensidade", Statistic.standard_deviation, aggregationBuffer, buffer, "UF = 'AM'")

Variância

Retorna a variância entre os valores do atributo das ocorrências que interceptam o objeto monitorado ou sua área de influência no intervalo de tempo informado.

Assinatura

terrama2.occurrence.zonal.aggregation.variance("dataSeriesName", "dateFilter", "attribute", aggregationStatistic, aggregationBuffer, buffer, "restriction")

Parâmetros

  • dataSeriesName: String com o nome da série de dados de ocorrências.
  • dateFilter: String com o intervalo de tempo para filtrar as ocorrências. (Ver Unidades de tempo )
  • attribute: String com o nome do atributo da ocorrência que deve ser utilizado para recuperar os valores, o atributo deve ser do tipo numérico (Ex. Integer, Float, Double, Long).
  • aggregationStatistic: Tipo de operador estatístico a ser utilizado para selecionar o valor do atributo para as ocorrências agregadas.
  • aggregationBuffer: Objeto Buffer para agregação. (Ver Buffer )
  • buffer: [Opcional] Objeto Buffer para ser aplicado ao objeto monitorado. Parâmetro obrigatório somente se o parâmetro seguinte (restriction) for utilizado. (Ver Buffer )
  • restriction: [Opcional] String com a restrição SQL a ser aplicada.

Exemplo de uso

buffer = Buffer()
aggregationBuffer = Buffer(BufferType.out_union, 2., "km")
x = occurrence.zonal.aggregation.variance("ocorrencias", "1d", "Intensidade", Statistic.standard_deviation, aggregationBuffer, buffer, "UF = 'AM'")