Função Estatística Focal

Calcula estatísticas sobre as células dentro de uma vizinhança ao redor de cada célula de um raster de entrada. Várias formas de bairro estão disponíveis.

Notas

Se o raster de entrada for do tipo ponto flutuante, somente as estatísticas Média, Máxima, Mediana, Mínima, Percentil, Faixa, Desvio Padrão e Soma estarão disponíveis.

Quando uma vizinhança circular, em forma de anel ou em forma de cunha é especificada, algumas das células diagonais externas podem não ser consideradas nos cálculos, pois o centro da célula deve ser englobado dentro da vizinhança.

As células NoData de entrada podem receber um valor na saída se a opção Ignorar Nodata em Cálculos estiver marcada, desde que pelo menos uma célula dentro da vizinhança tenha um valor válido.

Para mais informações sobre esta função, veja o tópico Como funciona a Estatística Focal.

Parâmetros

Nome do parâmetroDescrição

Raster

(Exigido)

O raster de entrada.

Vizinhança

O formato da área ao redor de cada célula utilizada para calcular a estatística.

Cada vizinhança tem parâmetros adicionais para definir a forma.

  • Retângulo, Largura, Altura

    Uma vizinhança retangular definida por largura e altura. O valor mínimo para largura ou altura é 1 célula, e o valor máximo é 4096 células. O padrão é um quadrado com largura e altura de três células.

  • Círculo, Raio

    Uma vizinhança circular com o raio fornecido. O valor mínimo do raio é 1 célula e o máximo é 2047 células. O raio padrão é de três células.

  • Anelar, Raio interno, Raio externo

    Um bairro em formato de anel ou círculo definido por um raio interno e um raio externo. O valor mínimo do raio é 1 célula e o raio externo deve ser maior que o interno. O raio interno máximo é de 2.046 células, e o raio externo máximo é de 2.047 células. O padrão anelar tem um raio interno de uma célula e um raio externo de três células.

  • Cunha, Raio, ângulo Inicial, ângulo Final

    Uma vizinhança em forma de cunha definida por um raio, o ângulo inicial e o ângulo final. O valor mínimo do raio é 1 célula e o máximo é 2047 células. A cunha se estende no sentido anti-horário do ângulo inicial até o ângulo final. Os ângulos são especificados em graus, com 0 ou 360 representando o leste. Ângulos negativos podem ser usados. A cunha padrão é de 0 a 90 graus, com um raio de três células.

  • Valores Irregular, Largura, Altura, Vizinhança

    A vizinhança irregular permite que você especifique uma vizinhança de formato irregular, ou núcleo, ao redor da célula de processamento. Utilize a tabela de valores de vizinhança para definir a forma do núcleo de vizinhança. Um valor de 1 indica que sua célula correspondente (e valor) seja um membro da vizinhança. Utilize um valor de 0 para excluir uma célula de processamento. O valor mínimo para largura ou altura do kernel é 1 célula, e o valor máximo é 4096 células.

  • Valores de Peso, Largura, Altura, Vizinhança

    A vizinhança de peso é semelhante ao tipo de vizinhança irregular, em que permite a você definir uma vizinhança irregular em torno da célula de processamento, mas ele permite a você aplicar pesos adicionalmente para os valores de entrada. Os valores no núcleo de peso especifica quais posições de célula devem ser incluídos dentro da vizinhança e os pesos pelos quais eles serão multiplicados. Utilize um valor de 0 para excluir uma célula de processamento. Valores decimais são válidos para usar como peso. O valor mínimo para largura ou altura do kernel é 1 célula, e o valor máximo é 4096 células.

Anotação:

Para o tipo de vizinhança de Peso, somente as estatísticas de Média, Desvio Padrão ou Soma são suportadas.

Tipo de Estatística

Especifica o tipo de estatística a ser calculado.

  • Média—Calcula a média (valor médio) das células na vizinhança.
  • Maioria—Determina a maioria (valor que ocorre com mais frequência) das células na vizinhança.
  • Máximo—Determina o máximo (maior valor) das células da vizinhança.
  • Mediana—Calcula a média das células na vizinhança. A mediana é equivalente ao percentil 50.
  • Mínimo—Determina o mínimo (menor valor) das células da vizinhança.
  • Minoria—Determina a minoria (valor que ocorre com menos frequência) das células da vizinhança.
  • Percentil—Calcula um percentil das células na vizinhança. Quando este tipo de estatística for selecionado, um novo parâmetro de Valor de Percentil ficará disponível, com o qual você pode determinar qual percentil calcular.
  • Intervalo—Determina o intervalo (diferença entre o maior e o menor valor) das células da vizinhança.
  • Desvio Padrão—Calcula o desvio padrão das células na vizinhança.
  • Soma—Calcula a soma (total de todos os valores) das células na vizinhança.
  • Variedade—Determina a variedade (o número de valores únicos) das células na vizinhança.

O tipo estatístico padrão é Média.

Se o raster de entrada for ponto flutuante, somente os tipos estatísticos Média, Máximo, Mediano, Mínimo, Percentil, Intervalo, Desvio Padrão e Soma estão disponíveis.

Para Média, Mediano, Percentil e Desvio Padrão, a saída é sempre de ponto flutuante.

Para Maioria e Minoria, se houver empate entre os valores com frequência mais alta (maioria) ou menor (minoria) na vizinhança, a localização da célula de processamento receberá o menor dos valores empatados. Se o valor da própria célula de processamento for um dos empates, esse valor será retornado.

Ignorar NoData nos Cálculos

Especifica se os valores NoData são ignorados pelo cálculo estatístico.

  • Marcado—Se existir um valor NoData em uma vizinhança, o valor NoData será ignorado. Somente células dentro da vizinhança que tenham valores de dados serão utilizadas em determinar o valor de saída. Este é o padrão.
  • Desmarcado—Se qualquer célula em uma vizinhança tiver um valor NoData, a saída para a célula de processamento será NoData.

Valor Percentil

Especifica qual percentil calcular quando Percentil for selecionado como o tipo de estatística. O padrão é 90, para o percentil de 90°.

Os valores podem variar de 0 até 100. O percentil 0° é equivalente essencialmente para a estatística Mínima e o percentil 100° é equivalente ao Máximo, com a exceção que o resultado será de ponto flutuante. Um valor de 50 irá produzir essencialmente o mesmo resultado como a estatística Mediana.

Arquivos Kernel

Para as vizinhanças Irregular e de Peso, você pode salvar um kernel personalizado como um arquivo de texto para uso posterior.

Após especificar a largura e a altura e inserir os valores da vizinhança, use o botão Salvar Como para exportá-lo para um arquivo de texto ASCII através da caixa de diálogo Salvar Arquivo de Kernel da Vizinhança. Use o botão Procurar para abrir a caixa de diálogo Arquivo do Kernel da Vizinhança de Entrada para procurar e especificar um arquivo de kernel existente para carregar.

A primeira linha no arquivo do kernel registra a largura e a altura da vizinhança do kernel em número de células. As linhas subsequentes indicam como o valor de entrada que corresponde a esse local no kernel será processado.

Um valor de 0 no arquivo do kernel para o tipo de vizinhança irregular ou de peso indica que o local correspondente não será incluído no cálculo. Para a vizinhança irregular, um valor de 1 no arquivo do kernel indica que a célula de entrada correspondente será incluída na operação. Para a vizinhança de peso, o valor em cada posição indica pelo qual o valor da célula de entrada correspondente deve ser multiplicado. Positivo, negativo e valores decimais são todas as opções válidas para utilizar como um peso.