Acumulação de Distância

A ferramenta Acumulação de Distância calcula a distância acumulada de cada célula às fontes de entrada.

Anotação:

Para executar esta ferramenta, o portal deve ser configurado para análise de raster.

Se você não vê esta ferramenta no Map Viewer, contacte seu administrador do portal. Seu portal pode não estar configurado para análise raster ou você pode não ter os privilégios necessários para executar a ferramenta.

Diagrama do fluxo de trabalho

Exemplos

Aplicações de exemplo incluem respostas a perguntas como as seguintes:

• Qual é a distância até a cidade mais próxima?
• Qual é a distância de custo até a estrada mais próxima?
• Qual é a distância ao redor das barreiras até a fonte de água mais próxima?

Anotações de uso

Quando a fonte de dados de entrada for um raster, o conjunto de células de origem consiste de todas as células no raster de origem que tenham valores válidos. As células com valores NoData não são incluídas no conjunto de origem. O valor 0 é considerado uma fonte legítima.

Quando a fonte de dados de entrada for uma feição, os locais de origem serão internamente convertidos para um raster antes de executar a análise. A resolução do raster pode ser controlada com o ambiente Tamanho da Célula . Por padrão, se nenhum outro raster for especificado na ferramenta, a resolução será determinada pelo menor entre a largura ou altura da extensão do recurso de entrada na referência espacial de entrada, dividido por 250.

Para evitar essa situação, como uma etapa intermediária, você pode rasterizar as feições de entrada diretamente com a ferramenta Converter feição para Raster e definir o parâmetro Campo. Então utilize a saída resultante como entrada para a ferramenta de distância em particular que deseja utilizar.

Se houver NoData em qualquer uma dessas entradas: raster de custo, raster de superfície, raster vertical ou raster horizontal, as células nesses locais em todas as entradas são ignoradas no cálculo. NoData em qualquer um desses rasters é persistido ao longo do cálculo e, portanto, é NoData em todas as saídas.

Se uma fonte cair em NoData em qualquer um dos rasters de entrada correspondentes, ela será ignorada na análise e, portanto, nenhuma distância dessa fonte será calculada.

O raster de custo não pode conter valores de zero, pois o algoritmo é um processo multiplicativo. Se seu raster de custo contiver valores de zero e esses valores representarem áreas de custo mais baixo, altere essas células para um pequeno valor positivo (como 0,01) antes de executar esta ferramenta.

Quando nenhuma configuração de ambiente Extensão é especificada, a extensão do processamento é determinada da seguinte maneira:

Se apenas a fonte e os dados de barreira forem especificados, a união das entradas, expandida por duas larguras de células em cada lado, é usada como a extensão do processamento. A razão pela qual o raster de saída é expandido em duas linhas e colunas é para que, quando as saídas são usadas em Caminho Favorável como Raster e Caminho Favorável como Linha, os caminhos gerados podem se mover ao redor das barreiras. Para utilizar a extensão como uma barreira implícita você deve explicitamente configurar a Extensão nas configurações de ambiente.

Se qualquer um dos seguintes conjuntos de dados raster for especificado: raster de superfície, raster de custo, raster vertical ou raster horizontal, a extensão do processamento é a interseção desses rasters.

Quando as configurações de ambiente de Tamanho da Célula ou Ajustar Raster não são especificadas e há vários rasters especificados como entradas, o Tamanho da Célula e o Ajustar Raster são definidos com base em uma ordem de precedência: raster de custo, raster de superfície, raster vertical, raster horizontal, dados de origem e dados de barreira.

A saída da ferramenta Derivar Aspecto pode ser usada como entrada para a configuração Raster horizontal de entrada.

Se qualquer um dos parâmetros de características de origem forem especificados utilizando um campo, a característica de origem será aplicado em uma base de origem por origem, de acordo com as informações no campo fornecido para a fonte de dados. Quando uma palavra-chave ou um valor constante é fornecido, ele será aplicado a todas as origens.

As características da origem ou os movedores de ou para uma origem, podem ser controlados pelos parâmetros específicos.

• Acumulação inicial define o custo inicial antes do início do movimento.
• Acumulação máxima especifica quanto o custo de uma fonte pode acumular antes de alcançar seu limite.
• O multiplicador a ser aplicado aos custos especifica o modo de viagem ou a magnitude na origem.
• A Direção de viagem identifica se o movimentador está iniciando em uma origem e movendo para locais sem origem ou iniciando em locais sem origem e retornando a uma origem.

If Initial accumulation is specified, the source locations on the output cost distance surface will be set to the Initial accumulation value; otherwise, the source locations on the output cost distance surface will be set to zero.

Os parâmetros desta ferramenta estão listados na seguinte tabela:

Parâmetro	Explanação
Escolher feições ou raster de origem	Um camada de feição ou raster que identifica as fontes para as quais a distância será calculada. Se a entrada for um raster, deverá consistir em células com valores válidos (zero é um valor válido) para as origens e as células restantes deverão ser atribuídas a NoData. Se a entrada for uma camada de feição, poderá ser um ponto, linha ou polígono.
Escolher feição ou raster de barreira (opcional)	O conjunto de dados que define as barreiras. Para um raster, o tipo de entrada pode ser inteiro ou flutuante. Quaisquer células com um valor (incluindo zero) serão tratadas como uma barreira. Quaisquer células que sejam NoData não serão tratadas como uma barreira. Para uma feição, a entrada pode ser um ponto, uma linha ou um polígono.
Escolher raster de superfície (opcional)	Especifica se o cálculo da distância utiliza um método plano (Terra plana) ou um método geodésico (elipsóide). Os valores são utilizados para calcular a distância de superfície real coberta ao analisar entre as células.
Escolher raster de custo (opcional)	Um raster definindo o custo ou impedância para mover planimetricamente através de cada célula. O valor de cada localização da célula representa a distância de unidade por custo para mover pela célula. Cada valor de localização de célula é multiplicado pela resolução de pixel, enquanto também compensando por movimento diagonal para obter o custo total de passagem pela célula. Os valores do custo de raster podem ser inteiros ou pontos flutuantes, mas eles não podem ser negativos ou zero (você não pode ter um custo negativo ou zero).
Escolher raster vertical (opcional)	Um raster definindo os valores z para cada local de célula. Os valores são utilizados para calcular a declividade para identificar o fator vertical incorrido ao mover de uma célula para outra.
Fator vertical (opcional)	O Fator vertical define o relacionamento entre o fator de custo vertical (VF) e o ângulo de movimento relativo vertical (VRMA). Esta opção só estará disponível se Escolher raster vertical (opcional) for especificado. Há diversos fatores com modificadores dos quais selecionar que identificam um gráfico de fator vertical definido. Os gráficos são utilizados para identificar o fator vertical utilizado no cálculo do custo total para mover em uma célula vizinha. Nas descrições abaixo, o VF define a dificuldade vertical encontrada ao se mover de uma célula para a próxima, e o modificador VRMA identifica o ângulo de inclinação entre as células Da origem e as células Para origem . Binário—Se o VRMA for maior que o ângulo de corte baixo e menor que o ângulo de corte alto, o VF será configurado para o valor associado com o fator zero; caso contrário, será infinito. Linear—O VF é uma função linear do VRMA. Linear Inversa—O VF é uma função linear inversa do VRMA. Linear simétrica—O VF é uma função linear do VRMA em um lado negativo ou positivo do VRMA, e as duas funções lineares são simétricas com respeito ao eixo (y) VF. Linear Inversa Simétrica—O VF é uma função linear inversa do VRMA em um lado negativo ou positivo do VRMA, e as duas funções lineares são simétricas com respeito ao eixo (y) VF. Cos—O VF é a função baseada em co-seno do VRMA. Sec—O VF é a função baseada em secante do VRMA. Cos-Sec—O VF é a função baseada em co-seno do VRMA quando o VRMA for negativo e a função baseada em secante do VRMA quando o VRMA for não negativo. Sec-Cos—O VF é a função baseada em secante do VRMA quando o VRMA for negativo e a função baseada em co-seno do VRMA quando o VRMA for não negativo. Os modificadores dos parâmetro verticais são os seguintes: Fator zero—O fator vertical utilizado quando o VRMA for zero. Este fator posiciona a opção interceptar y da função especificada. Por definição, o fator zero não é aplicável a nenhuma das funções verticais trigonométricas (Cos, Sec, Cos-Sec ou Sec-Cos). A opção interceptar y é definida por estas funções. Ângulo de corte baixo—O ângulo VRMA abaixo no qual o VF será configurado para infinito. Ângulo de corte alto—O ângulo VRMA acima no qual o VF será configurado para infinito. Declividade—A declividade da linha reta utilizada com os parâmetros Linear e Linear Inverso . A declividade é especificada como uma fração de subida acima do percurso (por exemplo, 45 porcento da declividade é 1/45, que é entrada como 0.02222).
Escolher raster horizontal (opcional)	Um raster definindo a direção horizontal em cada localização de célula. Os valores no raster devem ser inteiros de 0 a 360, com 0 os graus sendo norte ou em direção ao topo da tela e aumentando à direita. As áreas planas recebem um valor de -1. Os valores em cada localização serão utilizados junto com o Fator horizontal para determinar o custo horizontal incorrido ao mover uma célula para seus vizinhos.
Fator horizontal (opcional)	O Fator horizontal define o relacionamento entre o fator de custo horizontal e o ângulo de movimento relativo horizontal. Esta opção está disponível apenas se Escolher raster horizontal (opcional) for especificado. Há diversos fatores com modificadores dos quais selecionar que identificam um gráfico de fator horizontal definido. Os gráficos são utilizados para identificar o fator horizontal utilizado no cálculo do custo total de movimento em uma célula vizinha. Nas descrições abaixo, o fator horizontal (HF) define a dificuldade horizontal encontrada ao se mover de uma célula para a próxima, e o ângulo de movimento relativo horizontal (HRMA) identifica o ângulo entre a direção horizontal de uma célula e a direção do movimento. As definições e parâmetros deste HF são as seguintes: Binário—Se o HRMA for menor que o ângulo de corte, o HF será configurado para o valor associado com o fator zero; caso contrário, será infinito. Adiante—Somente o movimento adiante é permitido. O HRMA deve ser maior ou igual a 0 e menor que 90 (0 <= HRMA < 90). Se o HRMA for maior que 0 e menor que 45 graus, o HF para a célula é configurada para o valor associado com o fator zero. Se o HRMA for maior ou igual a 45 graus, o modificador de valor lateral é utilizado. O HF para qualquer HRMA igual ou maior que 90 graus é configurado para infinito. Linear—O HF é uma função linear do HRMA. Linear Inversa—O HF é uma função linear inversa do HRMA. Os modificadores das palavras-chaves horizontais são os seguintes: Fator zero—O fator horizontal a ser utilizado quando o HRMA for 0. Este fator posiciona a opção interceptar y para qualquer uma das funções de fator horizontal. Ângulo de Corte—O ângulo de HRMA além do qual o HF será definido para infinito. Declividade—A declividade da linha reta utilizada com as palavras-chaves de fator horizontal Linear e Linear Inversa . A declividade é especificada como uma fração de subida acima do percurso (por exemplo, 45 porcento da declividade é 1/45, que é entrada como 0.02222). Valor Lateral—O HF quando o HRMA for maior ou igual a 45 graus e menor que 90 graus quando a palavra-chave de fator horizontal Adiante for especificada.
Acumulação inicial (opcional)	O custo acumulativo inicial para iniciar o cálculo de custo. Isto permite a especificação do custo fixo associado com uma origem. Em vez de iniciar a um custo de zero, o algoritmo de custo começará com o valor definido por Acumulação inicial. Os valores devem ser zero ou maiores. O padrão é 0.
Acumulação máxima (opcional)	A acumulação máxima para o viajante de uma origem. Os cálculos de custo continuam para cada origem até que a acumulação especificada seja alcançada. Os valores devem ser maiores que zero. O acúmulo padrão é até a borda do raster de saída.
Multiplicador de custo (opcional)	O multiplicador para aplicar aos valores de custo. Isto permite o controle do modo de viagem ou a magnitude em uma origem. Quanto maior o multiplicador, maior o custo para mover por cada célula. Os valores devem ser maiores que zero. O padrão é 1.
Direção do percurso (opcional)	Especifica a direção do viajante ao aplicar fatores horizontais e verticais. Da origem—O fator vertical e o fator horizontal serão aplicados no início da origem de entrada e saindo para células diferentes da origem. Este é o padrão. Para origem—O fator vertical e o fator horizontal serão aplicados começando em cada célula diferente da origem e voltando para a origem de entrada. Especifique a palavra-chave Da origem ou Para origem , que será aplicada a todas as origens ou especifique um campo nos dados de origem que contenha as palavras-chaves para identificar a direção de viagem de cada origem. O campo deve conter a string FROM_SOURCE ou TO_SOURCE.
Método de distância (opcional)	Especifica se o cálculo da distância utiliza um método plano (Terra plana) ou um método geodésico (elipsóide). Planar—O cálculo da distância será executado em um plano projetado utilizando um sistema de coordenada Cartesiano 2D. Este é o método padrão. Geodésico—O cálculo da distância será realizado no elipsóide. Portanto, não importando a projeção de entrada ou de saída, os resultados não alteram.
Nome do raster de acumulação de distância resultante	O raster de acumulação de distância contém a distância acumulativa para cada célula de, ou para, a origem de menor custo. O raster de saída é do tipo flutuante. O nome da camada que será criada em Meu Conteúdo e adicionada ao mapa. O nome padrão é baseado no nome da ferramenta e o nome da camada de entrada. Se a camada já existir, você será solicitado para fornecer outro nome. Você pode especificar o nome de uma pasta em Meu Conteúdo onde o resultado será salvo utilizando a caixa suspensa Salvar resultados em .
Nome do raster de direção de volta resultante (opcional)	O raster de direção de volta contém a direção calculada em graus. A direção identifica a próxima célula ao longo do caminho mais curto de volta até a origem mais próxima, evitando barreiras. A faixa de valores é de 0 graus a 360 graus, com 0 reservado para as células de origem. Devido ao Leste (direita) ser 90 e os valores aumentarem no sentido horário (180 é Sul, 270 é Oeste e 360 é Norte). O raster de saída é do tipo flutuante. O nome da camada que será criada em Meu Conteúdo e adicionada ao mapa. O nome padrão é baseado no nome da ferramenta e o nome da camada de entrada. Se a camada já existir, você será solicitado para fornecer outro nome. Você pode especificar o nome de uma pasta em Meu Conteúdo onde o resultado será salvo utilizando a caixa suspensa Salvar resultados em .
Nome do raster de direção de origem resultante (opcional)	O raster de direção de origem identifica a direção da célula de origem de menor custo acumulado como um azimute em graus. A faixa de valores é de 0 graus a 360 graus, com 0 reservado para as células de origem. Devido ao Leste (direita) ser 90 e os valores aumentarem no sentido horário (180 é Sul, 270 é Oeste e 360 é Norte). O raster de saída é do tipo flutuante. O nome da camada que será criada em Meu Conteúdo e adicionada ao mapa. O nome padrão é baseado no nome da ferramenta e o nome da camada de entrada. Se a camada já existir, você será solicitado para fornecer outro nome. Você pode especificar o nome de uma pasta em Meu Conteúdo onde o resultado será salvo utilizando a caixa suspensa Salvar resultados em .
Nome do raster de localização de origem resultante (opcional)	O raster de localização de origem é uma saída de múltiplas bandas. A primeira banda contém um índice de linha e a segunda banda contém um índice de coluna. Estes índices identificam o local da célula de origem que é a menor distância de custo acumulada. O nome da camada que será criada em Meu Conteúdo e adicionada ao mapa. O nome padrão é baseado no nome da ferramenta e o nome da camada de entrada. Se a camada já existir, você será solicitado para fornecer outro nome. Você pode especificar o nome de uma pasta em Meu Conteúdo onde o resultado será salvo utilizando a caixa suspensa Salvar resultados em .

Ambientes

As configurações do ambiente de análise são parâmetros adicionais que afetam os resultados de uma ferramenta. Você pode acessar as configurações do ambiente de análise da ferramenta clicando no ícone de engrenagem na parte superior do painel de ferramentas.

Esta ferramenta honra os seguintes Ambientes de Análise:

• Sistema de coordenadas de saída—Especifica o sistema de coordenadas da camada de saída.
• Extensão—Especifica a área a ser usada para análise.
• Ajustar Raster—Ajusta a extensão da saída para que corresponda ao alinhamento da célula da camada raster de ajuste especificada.
• Tamanho da célula—O tamanho da célula a ser usado na camada de saída.
• Máscara—Especifica uma camada de máscara, onde apenas as células que se enquadram na área de máscara serão usadas para análise.

Ferramentas e funções raster semelhantes

A ferramenta Acumulação de Distância calcula a distância acumulada de cada célula às fontes de entrada. Outras ferramentas podem ser úteis na solução de problemas semelhantes.

Ferramentas de análise e funções raster do Map Viewer

Use a ferramenta Alocação de Distância ou a função raster de Alocação de Distância se uma saída de serviço de imagem de alocação de distância for necessária.

A Acumulação de Distância também está disponível como uma função de raster.

Ferramentas de análise e funções raster ArcGIS Pro

As ferramentas de geoprocessamento Alocação de Distância e Acúmulo de Distância estão disponíveis na caixa de ferramentas Spatial Analyst.

As ferramentas de geoprocessamento Alocação de Distância e Acúmulo de Distância estão disponíveis na caixa de ferramentas Raster Analysis.

Alocação de Distância e Acúmulo de Distância estão disponíveis como funções raster.

Recursos de desenvolvedores do ArcGIS Enterprise

Se você estiver trabalhando no ArcGIS REST API, utilize as tarefas Distance Accumulation e Distance Allocation.

Se você estiver trabalhando no ArcGIS API for Python, use Distance Accumulation e Distance Allocation do módulo arcgis.raster.functions.gbl.