r.neighboursgrass - Online na nuvem

PROGRAMA:

NOME

vizinhos - Torna cada valor de categoria de célula uma função dos valores de categoria atribuídos
às células ao seu redor e armazena novos valores de células em uma camada de mapa raster de saída.

CHAVES

raster, álgebra, estatísticas, agregação, vizinho, estatísticas focais, filtro

SINOPSE

vizinhos
vizinhos --Socorro
vizinhos [-ac] entrada=nome [doadores, =nome] saída=nome[,nome, ...]
[método=corda[,corda, ...]] [tamanho=número inteiro] [título=frase] [peso=nome]
[gauss=flutuar] [quantil=flutuar[,flutuar, ...]] [-substituir] [-ajudar] [-detalhado]
[-calma] [-ui]

Sinalizadores:
-a
Não alinhe a saída com a entrada

-c
Use vizinhança circular

- sobrescrever
Permitir que os arquivos de saída substituam os arquivos existentes

--Socorro
Imprimir resumo de uso

--verbose
Saída detalhada do módulo

--quieto
Saída silenciosa do módulo

--ui
Forçar o lançamento da caixa de diálogo da GUI

parâmetros:
entrada=nome [obrigatório]
Nome do mapa raster de entrada

doadores, =nome
Nome de um mapa raster de entrada para selecionar as células que devem ser processadas

saída=nome nome, ...] [obrigatório]
Nome para o mapa raster de saída

método=string [, string, ...]
Operação de bairro
opções: média, mediana, Modo, mínimo, máximo, range, stddev, soma, contagem, variância,
diversidade, interspersão, trimestre1, trimestre3, perc90, quantil
Padrão: média

tamanho=número inteiro
Tamanho da vizinhança
Padrão: 3

título=frase
Título para mapa raster de saída

peso=nome
Arquivo de texto contendo pesos

gauss=flutuar
Sigma (em células) para filtro Gaussiano

quantil=float [, float, ...]
Quantil a calcular para o método = quantil
opções: 0.0-1.0

DESCRIÇÃO

vizinhos olha para cada célula em um arquivo de entrada raster e examina os valores atribuídos a
as células em alguma "vizinhança" definida pelo usuário em torno dele. Ele produz um novo mapa raster
camada na qual cada célula recebe um valor que é alguma função (especificada pelo usuário) do
valores na vizinhança dessa célula. Por exemplo, cada célula na camada de saída pode ser
atribuiu um valor igual à média dos valores que aparecem em sua célula 3 x 3
"vizinhança" na camada de entrada. Observe que a célula central também está incluída no
Cálculo.

OPÇÕES
O usuário deve especificar os nomes das camadas do mapa raster a serem usadas para entrada e saída,
da método usado para analisar valores de vizinhança (ou seja, a função de vizinhança ou
operação a ser realizada), e o tamanho do bairro.

O usuário pode, opcionalmente, especificar um doadores, mapa, para calcular novos valores apenas onde o
células raster do mapa de seleção não são NULL. No caso de células NULL, os valores de
o mapa de entrada é copiado para o mapa de saída. Isso pode ser útil para suavizar apenas partes de um
mapa de elevação (poços, picos, ...).

Exemplo como para usar a doadores, mapa, com método = média:
mapa de entrada:
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 10 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
mapa de seleção, os valores NULL são marcados como *:
* * * * *
* * 1 * *
*1 1 1 *
* * 1 * *
* * * * *
O mapa de saída:
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 2 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 2 2 2 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 2 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
Sem usar o mapa de seleção, o mapa de saída ficaria assim:
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 2 2 2 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 2 2 2 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 2 2 2 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 1 1 1 1 Portugal: +XNUMX XNUMX XNUMX XNUMX

Opcionalmente, o usuário também pode especificar o IMERSÃO DE INGLÊS a ser atribuído à camada de mapa raster
saída, opte por não alinhar a resolução da saída com a da entrada (o -a
opção), e executar vizinhos com uma matriz personalizada pondera com o peso opção. Esses
as opções são descritas mais abaixo.

Área Ex: "Parque das Nações" Divisão de Métodos: O Vizinhança operadores determinam qual novo valor um
célula central em uma vizinhança terá, após examinar os valores dentro de sua vizinhança
células. Cada célula em uma camada de mapa raster se torna a célula central de uma vizinhança como o
a janela da vizinhança se move de uma célula para outra em toda a camada do mapa. vizinhos pode
execute as seguintes operações:

média
O valor médio na vizinhança. No exemplo a seguir, o resultado seria
estar:
(7 * 4 + 6 + 5 + 4 * 3) / 9 = 5.66
O resultado é arredondado para o número inteiro mais próximo (neste caso, 6).

mediana
O valor encontrado no meio de uma lista de valores do bairro, quando estes são
variou em ordem numérica.

modo
O valor que ocorre com mais frequência na vizinhança.

mínimo
O valor mínimo na vizinhança.

máximo
O valor máximo na vizinhança.
Dados brutos de operação de novos dados
+ --- + --- + --- + + --- + --- + --- +
| 7 7 5 | | | | |
+ --- + --- + --- + média + --- + --- + --- +
| 4 7 4 | ---------> | | 6 |
+ --- + --- + --- + + --- + --- + --- +
| 7 6 4 | | | | |
+ --- + --- + --- + + --- + --- + --- +

alcance
O valor do intervalo na vizinhança.

stddev
O desvio padrão estatístico dos valores na vizinhança (arredondado para o
número inteiro mais próximo).

soma
A soma dos valores na vizinhança.

variação
A variação estatística dos valores dentro da vizinhança (arredondado para o mais próximo
inteiro).

diversidade
O número de valores diferentes na vizinhança. No exemplo acima, o
a diversidade é 4.

interspersão
A porcentagem de células contendo valores que diferem dos valores atribuídos ao
célula central na vizinhança, mais 1. No exemplo acima, a interspersão é:
5/8 * 100 + 1 = 63.5
O resultado é arredondado para o número inteiro mais próximo (neste caso, 64).

Área Ex: "Parque das Nações" Tamanho: A vizinhança tamanho especifica quais células ao redor de qualquer célula
cair na vizinhança para essa célula. o tamanho deve ser um número inteiro ímpar e representar
o comprimento de uma das bordas da janela em movimento nas células. Por exemplo, um valor de tamanho de 3 irá
provocar
___
| _ | _ | _ |
Bairro 3 x 3 ---> | _ | _ | _ |
| _ | _ | _ |

Matriz pesos: Uma matriz personalizada pode ser usada se nenhum dos métodos de operação de vizinhança
são desejáveis ​​usando o peso. Esta opção deve ser usada em conjunto com o tamanho
opção para especificar o tamanho da matriz. Os pesos desejados devem ser inseridos em um texto
Arquivo. Por exemplo, para calcular a média focal com uma matriz tamanho de 3,
r.neigbours in = input.map out = output.map size = 3 weight =pes.txt
O conteúdo do arquivo weight.txt:
3 3 3
1 4 8
9 5 3
Isso corresponde à seguinte matriz 3x3:
+ - + - + - +
| 3 | 3 | 3 |
+ - + - + - +
| 1 | 4 | 8 |
+ - + - + - +
| 9 | 5 | 3 |
+ - + - + - +
Para calcular uma vizinhança em forma de anular, o conteúdo do arquivo weight.txt pode ser, por exemplo,
para tamanho = 5:
+0 1 1 1 0 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 0 0 0 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 0 0 0 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+1 0 0 0 1 Portugal: +XNUMX XNUMX XNUMX XNUMX
+0 1 1 1 0 Portugal: +XNUMX XNUMX XNUMX XNUMX
A forma como os pesos são usados ​​depende do agregado específico (método) sendo usado.
No entanto, a maioria dos agregados tem a propriedade de multiplicar todos os pesos por
o mesmo fator não mudará o resultado final (uma exceção é método = contagem) Além disso, a maioria
(se não todos) eles têm as propriedades de que um peso inteiro de N é equivalente a N
ocorrências do valor da célula, e tendo todos os pesos iguais a um produz o mesmo
resultado como quando os pesos não são usados. Quando os pesos são usados, o cálculo para
método = média é:
soma (w [i] * x [i]) / soma (w [i])
No caso em que todos os pesos são zero, isso terminará com o numerador e
denominador para zero, o que produz um resultado NULL.

BANDEIRAS
-a
Se especificado, vizinhos não irá alinhar a camada do mapa raster de saída com a do
camada de mapa raster de entrada. o vizinhos programa funciona na área geográfica atual
região. É recomendado, mas não obrigatório, que a resolução do
região seja a mesma da camada do mapa raster. Por padrão, se não for especificado,
vizinhos irá alinhar essas configurações de região geográfica.

-c
Este sinalizador usará uma vizinhança circular para a janela de análise móvel, centrada em
a célula atual.

As máscaras exatas para os primeiros tamanhos de vizinhança são as seguintes:
3x3. X 5x5. . X . 7x7. . . X . .
XOX. XXX. . XXXXX.
. X XXOXX. XXXXX.
. XXX. XXXOXXX
. . X . . XXXXX.
. XXXXX.
. . . X . .
9x9. . . . X . . . 11x11. . . . . X . . . .
. . XXXXX. . . . XXXXXXX. .
. XXXXXXX. . XXXXXXXXX.
. XXXXXXX. . XXXXXXXXX.
XXXXOXXXX. XXXXXXXXX.
. XXXXXXX. XXXXXOXXXXX
. XXXXXXX. . XXXXXXXXX.
. . XXXXX. . . XXXXXXXXX.
. . . . X . . . . XXXXXXXXX.
. . XXXXXXX. .
. . . . . X . . . .

NOTAS

O vizinhos programa funciona na região geográfica atual com a máscara atual, se
algum. É recomendado, mas não obrigatório, que a resolução da região geográfica seja
o mesmo da camada do mapa raster. Por padrão, vizinhos irá alinhar estes
configurações de região geográfica. No entanto, o usuário pode optar por manter a entrada original e
resoluções de saída que não estão alinhadas especificando isso (por exemplo, usando o -a opção).

vizinhos não propaga NULLs, mas calcula a agregação sobre as células não NULL em
a vizinhança.

O -c bandeira e o pesos parâmetro são mutuamente exclusivos. Qualquer uso dos dois juntos
irá produzir um erro. Janelas de análise de vizinhança com formatos diferentes podem ser alcançadas por
usando o peso = parâmetro para especificar um arquivo de pesos onde todos os valores são iguais. O usuário
também pode variar os pesos na borda da vizinhança de acordo com a proporção de
a célula que fica dentro do círculo de vizinhança, efetivamente suavizando a análise
mascarar.

Para agregados onde um cálculo ponderado não é significativo (especificamente: mínimo,
máximo, diversidade e interspersão), os pesos são usados ​​para criar uma máscara binária, onde
zero faz com que a célula seja ignorada e qualquer valor diferente de zero faz com que a célula seja usada.

vizinhos copia o GRASS cor arquivos associados à camada de mapa raster de entrada para
aquelas camadas do mapa de saída que são baseadas na média da vizinhança, mediana, modo, mínimo,
e máximo. Porque o desvio padrão, variância, diversidade e interspersão são
índices, em vez de correspondentes diretos aos valores de entrada, não cor os arquivos são copiados para
essas camadas do mapa. (O usuário deve notar que embora o cor arquivo é copiado para
média saída da função de vizinhança, independentemente de o arquivo de cores fazer sentido para o
a saída dependerá dos valores dos dados de entrada.)

Propagação of saída precisão
A seguinte lógica foi implementada: Para qualquer agregado, existem dois fatores
afetando o tipo de saída:

1 Se o mapa de entrada é inteiro ou de ponto flutuante.

2 Se a versão ponderada ou não ponderada do agregado é usada.

Eles se combinam para criar quatro possibilidades:

tipo de entrada inteiro inteiro flutuante flutuante

ponderado não sim não sim

flutuação média, flutuação, flutuação, flutuação

mediana [1] [1] flutuação flutuante

modo inteiro inteiro [2] [2]

mínimo inteiro inteiro flutuante flutuante

máximo inteiro inteiro flutuante flutuante

intervalo inteiro inteiro flutuante flutuante

stddev flutuar flutuar flutuar flutuar

soma inteiro flutuante flutuante flutuante

contagem inteiro flutuante inteiro flutuante

variação flutuante flutuante flutuante flutuante

diversidade inteiro inteiro inteiro inteiro inteiro

interspersão inteiro inteiro inteiro inteiro inteiro

quart1 [1] [1] flutuador flutua

quart3 [1] [1] flutuador flutua

perc90 [1] [1] flutuante flutuante

quantil [1] [1] float float

[1] Para entrada de número inteiro, quantis podem produzir resultados flutuantes a partir da interpolação entre
valores adjacentes.
[2] O cálculo do modo de dados de ponto flutuante é essencialmente sem sentido.

Com os agregados atuais, existem 5 casos:

1 A saída é sempre flutuante: média, variância, stddev, quantis (com interpolação).

2 A saída é sempre inteira: diversidade, interspersão.

3 A saída é inteira se não ponderada, float se ponderada: contagem.

4 A saída corresponde à entrada: mínimo, máximo, intervalo, modo (sujeito à nota 2 acima),
quantis (sem interpolação).

5 A saída é um número inteiro para entrada inteira e agregado não ponderado, caso contrário, float: soma.

Use r.neighsgrass online usando serviços onworks.net