A ferramenta Acumulação de Distância calcula a distância acumulada de cada célula às fontes de entrada.
Anotação:
Esta ferramenta está agora disponível no Map Viewer, uma ferramenta de criação de mapa moderna no ArcGIS Enterprise. Para saber mais, consulte Alocação de Distância (Map Viewer).
Para executar esta ferramenta, a organização deve estar configurada para análise de raster.
Se você não vê esta ferramenta no Map Viewer Classic, contacte seu administrador da organização. 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
Os dados da fonte de entrada podem ser uma classe de feição ou um raster. A classe de feição pode ser ponto, linha ou polígono.
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 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.
Se o raster de superfície de entrada tiver um sistema de coordenadas verticais (VCS), os valores do raster de superfície serão considerados nas unidades do VCS. Se o raster da superfície de entrada não tiver um VCS e os dados estiverem projetados, os valores de superfície serão considerados para estarem nas unidades lineares da referência espacial. Se o raster da superfície de entrada não tiver um VCS e os dados não estiverem projetados, os valores de superfície serão considerados para estarem em metros. O resultado final do acúmulo de distância está em custo por unidade linear ou em unidades lineares se nenhum custo for introduzido.
Barreiras são obstáculos que devem ser contornados. Eles podem ser definidos de duas maneiras.
Para o parâmetro Escolher raster de barreira ou feição, as barreiras podem ser representadas por células que possuem um valor válido ou por dados de feição que são convertidos em um raster. Onde as barreiras são conectadas apenas por células diagonais, as barreiras serão engrossadas para torná-las impermeáveis.
As barreiras também são definidas por locais onde existem células NoData nas seguintes entradas:Escolha o raster de custo, Escolha raster de superfície, Escolha raster vertical, e Escolha raster horizontal. Onde NoData é conectado apenas por células diagonais, ele será engrossado com células NoData adicionais para torná-lo uma barreira impermeável.
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.
Os valores padrão dos modificadores do Fator Vertical são os seguintes:
Keyword Zero Low High Slope Power Cos Sec factor cut cut power power angle angle ------------------------ ------ ----- ----- ----- ----- ----- ----- Binary 1.0 -30 30 ~ ~ ~ ~ Linear 1.0 -90 90 1/90 ~ ~ ~ Symmetric linear 1.0 -90 90 1/90 ~ ~ ~ Inverse linear 1.0 -45 45 -1/45 ~ ~ ~ Symmetric inverse linear 1.0 -45 45 -1/45 ~ ~ ~ Cos ~ -90 90 ~ 1.0 ~ ~ Sec ~ -90 90 ~ 1.0 ~ ~ Cos_sec ~ -90 90 ~ ~ 1.0 1.0 Sec_cos ~ -90 90 ~ ~ 1.0 1.0
A saída da ferramenta Derivar Aspecto pode ser usada como entrada para o parâmetro Escolher raster horizontal.
Os valores padrões dos modificadores do fator Horizontal são os seguintes:
Keywords Zero factor Cut angle Slope Side value -------------- ----------- ----------- ----- --------- Binary 1.0 45 ~ ~ Forward 0.5 45 (fixed) ~ 1.0 Linear 0.5 181 1/90 ~ Inverse linear 2.0 180 -1/90 ~
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.
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.
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.
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, será 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 usar a extensão como uma barreira implícita, você deve definir explicitamente o valor Extensão nas configurações do ambiente.
A extensão de processamento será a intersecção do raster de superfície, raster de custo, raster vertical ou raster horizontal, se especificado.
O ambiente de Máscara de análise pode ser definido como uma classe de feição ou um conjunto de dados raster. Se a máscara for uma feição, ela será convertida em um raster. As células que possuem um valor definem os locais que estão dentro da área da máscara. As células NoData definem os locais que estão fora da área de máscara e serão tratadas como Barreiras.
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, os ambientes Tamanho da Célula e 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.
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 um serviço da feição, a entrada pode ser ponto, linha ou polígono. |
Escolher raster de superfície (opcional) | Especifica se a distância será calculada usando um método plano (terra plana) ou 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 estará disponível somente se Escolher raster vertical (opcional) for especificado. Há vários fatores com modificadores que identificam um gráfico de fator vertical definido. Os gráficos são usados para identificar o fator vertical usado no cálculo do custo total de alteração para 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 .
Os modificadores dos parâmetro verticais são os seguintes:
|
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 local serão usados em conjunto com o parâmetro Fator horizontal para determinar o custo horizontal incorrido ao mover de uma célula para suas vizinhas. |
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 estará disponível somente se Escolher raster horizontal (opcional) for especificado. Há vários fatores com modificadores 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:
Os modificadores das palavras-chaves horizontais são os seguintes:
|
Acumulação inicial (opcional) | O custo acumulativo inicial que será usado para iniciar o cálculo do 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 que será aplicado 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 a distância será calculada usando um método plano (terra plana) ou geodésico (elipsóide).
|
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.
- Fator de processamento paralelo—Controla as instâncias de CPU ou GPU de processamento raster.
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 Classic
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, use as tarefas Distance Accumulation ou Distance Allocation.
Se você estiver trabalhando no ArcGIS API for Python, utilize o distance_accumulation e distance_allocation a partir do módulo arcgis.raster.functions.gbl.