Acumulação de Distância (Map Viewer Classic)

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 . 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 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: 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 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). 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. Independentemente da projeção de entrada ou saída, os resultados não mudarão.
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.