Lo strumento Accumulazione Distanza calcola la distanza accumulata da ogni cella per le origini di input.
Nota:
Questo strumento è ora disponibile in Map Viewer, il moderno strumento di creazione mappa di ArcGIS Enterprise. Per ulteriori informazioni, consultare Accumulo distanza (Map Viewer).
Per eseguire questo strumento, il portale deve essere configurato per analisi di raster.
Se non si visualizza questo strumento in Map Viewer classico, contattare l'amministratore dell'organizzazione. Il portale potrebbe non essere configurato per analisi di raster o potrebbe non disporre dei privilegi richiesti per eseguire lo strumento.
Diagramma del Workflow
Esempi
Le applicazioni di esempio includono risposte a domande come le seguenti:
- Qual è la distanza dalla città più vicina?
- Qual è la distanza di costo alla strada più vicina?
- Qual è la distanza attorno alle barriere dell'origine di acqua più vicina?
Note sull'utilizzo
I dati di origine dell'input possono essere una feature class o un raster. La feature class può essere punto, linea o poligono.
Quando i dati dell’origine di input sono raster, il set di celle di input è costituito da tutte le cellule nel raster di origine con valori validi. Le celle con valori NoData non sono inclusi nel set di origine. Il valore 0 è considerato un’origine legittima.
Quando i dati fonte di input è una feature, le posizioni di fonti sono convertite internamente a un raster prima di eseguire l'analisi. La risoluzione del raster può essere controllata con l'ambiente Dimensione cella. Per impostazione predefinita, se non sono specificati altri raster nello strumento, la risoluzione sarà determinata dal più corto tra la larghezza o l'altezza dell'estensione della caratteristica di input nel riferimento spaziale di input, diviso per 250.
Per evitare questa situazione, come un'operazione intermedia, è possibile rasterizzare le feature di input direttamente con lo strumento Converti Feature a Raster e impostare il parametro Campo. Quindi, utilizzare l'output risultante come input per il particolare strumento di distanza che si desidera utilizzare.
Se una sorgente cade su NoData in uno qualsiasi dei corrispondenti raster di input, viene ignorata nell'analisi, e quindi non verrà calcolata alcuna distanza da quella sorgente.
Se l'input Raster superficie ha un sistema di coordinate verticale (VCS), i valori del raster di superficie sono considerati in unità del VCS. Se l'input Raster di superficie non ha un VCS e i dati sono proiettati, i valori di superficie sono considerati nelle unità lineari del riferimento spaziale. Se l'input Raster di superficie non ha un VCS e i dati non sono proiettati, i valori di superficie sono considerati in metri. Il risultato finale dell'accumulazione della distanza è in costo per unità lineare, o in unità lineari se non viene introdotto alcun costo.
Le barriere sono ostacoli che devono essere aggirati. Possono essere definite in due modi.
Per il parametro Scegli barriera raster o feature, le barriere possono essere rappresentate da celle che hanno un valore valido o da dati feature che sono convertiti in un raster. Dove le barriere sono collegate solo da celle diagonali, le barriere saranno ispessite per renderle impermeabili.
Le barriere sono anche definite dalle posizioni in cui esistono celle NoData nei seguenti input: Scegli raster di costo, Scegli raster di superficie, Scegli raster verticale e Scegli raster orizzontale. Dove NoData è collegato solo da celle diagonali, sarà ispessito con ulteriori celle NoData per renderlo una barriera impermeabile.
Il raster di costo non può contenere i valori di zero da quando l'algoritmo è un processo moltiplicativo. Se il raster di costo contiene valori di zero e questi valori rappresentano aree di costo minore, modificare quelle celle a un valore positivo piccolo (come a 0.01) prima di eseguire questo strumento.
I valori predefiniti per i modificatori del fattore verticale sono i seguenti:
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.0L'output dello strumento Deriva aspetto può essere usato come input per il parametro Scegliere raster orizzontale.
I valori predefiniti per i modificatori di Fattore orizzontale sono i seguenti:
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 ~
Le caratteristiche della sorgente, o i movimenti da o a una sorgente, possono essere controllati dai seguenti parametri.
- Accumulazione iniziale imposta il costo iniziale prima che lo spostamento inizi.
- Accumulazione massima specifica quanto costi una fonte possa accumulare prima di raggiungere il proprio limite.
- Moltiplicatore da applicare ai costi specifica la modalità di viaggio o la grandezza all'origine.
- Direzione di viaggio identifica se il movimento parte da un'origine e si sposta su posizioni non di origine, oppure se parte da posizioni non di origine e torna a un'origine.
Se uno dei parametri delle caratteristiche di origine viene specificato utilizzando un campo, la caratteristica di origine verrà applicata da origine ad origine, in base alle informazioni del campo specificato per i dati di origine. Quando viene fornita una parola chiave o un valore costante, verrà applicata a tutte le origini.
Se Accumulazione iniziale è specificata, le posizioni di origine sulla superficie di distanza di costo di output verrà impostata al valore Accumulazione iniziale; altrimenti, le posizioni di origine sulla superficie di distanza di costo di output verrà impostata su zero.
Quando nessuna impostazione di ambiente Estensione viene specificata, l'estensione di elaborazione è determinata nel modo seguente:
Se sono specificati solo i dati della sorgente e della barriera, l'unione degli input, espansa di due larghezze di cella per lato, sarà usata come estensione di elaborazione. La ragione per cui il raster di uscita è espanso di due righe e colonne è così che quando gli output possono essere usati in Percorso ottimale come raster e Percorso ottimale come linea i percorsi generati possono muoversi intorno alle barriere. Per usare l'estensione come barriera implicita, devi impostare esplicitamente il valore Estensione nelle impostazioni dell'ambiente.
L'estensione di elaborazione sarà l'intersezione di raster di superficie, raster di costo, raster verticale o raster orizzontale, se specificato.
L'ambiente della maschera di analisi può essere impostato su una classe di caratteristiche o su un set di dati raster. Se la maschera è una caratteristica, sarà convertita in un raster. Le celle che hanno un valore definiscono le posizioni che sono all'interno dell'area della maschera. Le celle NoData definiscono le posizioni che sono al di fuori dell'area della maschera e saranno trattate come Barriere.
Quando le impostazioni dell'ambiente Dimensione cella o Snap Raster non sono specificate, e ci sono più raster specificati come input, gli ambienti Dimensione cella e Snap Raster sono impostati in base a un ordine di precedenza: raster di costo, raster di superficie, raster verticale, raster orizzontale, dati sorgente e dati barriera.
I parametri per questo strumento sono elencati nella tabella seguente:
| Parametro | Spiegazione |
|---|---|
| Scegliere raster di origine o feature | Un raster o layer feature che identifica le origini dalle quali la distanza verrà calcolata. Se l'input è un raster, deve consistere di celle che hanno valori validi (zero è un valore valido) per le origini e le celle rimanenti devono essere assegnate NoData. Se l'input è un layer feature, può essere un punto, una linea o un poligono. |
| Scegliere un raster di barriera o un feature (opzionale) | Il dataset che definisce le barriere. Per un raster, il tipo di input può essere intero o mobile. Ogni cella che dispone di un valore (incluso lo zero) sarà trattata come barriera. Ogni cella che sia un NoData non verrà trattata come una barriera. Per un feature service, l'input può essere puntuale, lineare o poligonale. |
| Scegliere un raster di superficie (opzionale) | Specifica se la distanza sarà calcolata usando un metodo planare (terra piatta) o geodetico (ellissoide). I valori vengono utilizzati per calcolare l’effettiva distanza della superficie percorsa durante il passaggio tra celle. |
| Scegliere un raster di costo (opzionale) | Un raster che definisce l'impedenza o il costo dello spostamento planimetrico attraverso ciascuna cella. Il valore ad ogni posizione di cella rappresenta la distanza costo per unità per lo spostamento attraverso di essa. Ogni valore di posizione di una cella viene moltiplicato per la risoluzione della cella, compensando al contempo il movimento diagonale per ottenere il costo totale dell'attraversamento della cella. I valori del raster di costo possono essere a numero intero o a virgola mobile, ma non possono essere negativi o zero (non è possibile disporre di un costo negativo o zero). |
| Scegliere un raster verticale (opzionale) | Un raster che definisce i valori z su ogni posizione della cella. I valori vengono utilizzati per calcolare la pendenza usata per identificare il fattore verticale quando si passa da una cella all'altra. |
| Fattore verticale (opzionale) | Il Fattore verticale definisce la relazione tra il fattore di costo verticale (VF) e l'angolo di movimento verticale relativo (VRMA). Questa opzione è disponibile solo se Scegliere un raster verticale (opzionale) è specificato. Ci sono diversi fattori con modificatori che identificano un grafico di fattore verticale definito. I grafici sono utilizzati per identificare il fattore verticale utilizzato nel calcolo del costo totale di spostamento in una cella vicina. Nelle descrizioni seguenti, il VF definisce la difficoltà verticale incontrata nello spostamento da una cella all'altra e il modificatore VRMA identifica l'angolo di pendenza tra la cella Da origine e la cella A origine.
I modificatori ai parametri verticali sono i seguenti:
|
| Scegliere un raster orizzontale (opzionale) | Un raster che definisce la direzione orizzontale su ogni cella. I valori sul raster devono essere numeri interi compresi tra 0 e 360 con 0 gradi che indica il nord o verso la parte superiore dello schermo e con aumento in senso orario. Alle aree piane deve essere fornito un valore di -1. I valori in ogni posizione saranno usati insieme al parametro Fattore orizzontale per determinare il costo orizzontale sostenuto quando ci si sposta da una cella ai suoi vicini. |
| Fattore orizzontale (opzionale) | Il Fattore orizzontale definisce la relazione tra il fattore di costo orizzontale e l'angolo di movimento relativo orizzontale. Questa opzione è disponibile solo se Scegliere un raster orizzontale (opzionale) è specificato. Ci sono diversi fattori con modificatori che identificano un grafico di fattori orizzontali definito. I grafici vengono utilizzati per identificare il fattore orizzontale utilizzato nel calcolo del costo totale per lo spostamento in una cella adiacente. Nelle descrizioni seguenti, il fattore orizzontale (HF) definisce la difficoltà orizzontale incontrata quando si passa da una cella all'altra e l'angolo di movimento orizzontale relativo (HRMA) identifica l'angolo tra la direzione orizzontale e una cella e la direzione di movimento. Le definizioni e i parametri di questi HF sono le seguenti:
I modificatori delle parole chiave orizzontali sono i seguenti:
|
| Accumulazione iniziale (opzionale) | Il costo cumulativo iniziale che verrà utilizzato per iniziare il calcolo dei costi. Questo permette la specificazione del costo fissato associato con un'origine. Invece di cominciare un costo di zero, l'algoritmo del costo inizierà con il valore impostato da Accumulazione iniziale. I valori devono essere pari o superiori a zero. L'impostazione predefinita è 0. |
| Accumulazione massima (opzionale) | L'accumulazione massima per il viaggiatore per un'origine. I calcoli di costo continuano per ogni origine fino a che l'accumulazione specifica viene raggiunta. I valori devono essere maggiori di zero. L'accumulazione predefinita è al bordo del raster di output. |
| Moltiplicatore costo (opzionale) | Il moltiplicatore che verrà applicato ai valori dei costi. Questo consente il controllo della modalità di spostamento o della grandezza all'origine. Maggiore è il moltiplicatore, maggiore è il costo per lo spostamento attraverso ogni cella. I valori devono essere maggiori di zero. Il valore predefinito è 1. |
| Direzione di viaggio (opzionale) | Specifica la direzione del viaggiatore quando si applicano fattori orizzontali e verticali. Da origine: il fattore orizzontale e il fattore verticale saranno applicati all'inizio dell'origine di input e spostandosi verso le celle non-origine. Si tratta dell'impostazione predefinita. A origine: il fattore orizzontale e il fattore verticale saranno applicati all'inizio di ogni cella non-origine, spostandosi verso le celle origine. Specifica la parola chiave Da origine o A origine, che sarà applicata a tutte le origini, o specifica un campo nei dati di origine che contiene le parole chiave per identificare la direzione di movimento per ogni origine. Quel campo deve contenere DA_ORIGINE o A_ORIGINE. |
| Metodo di distanza (opzionale) | Specifica se la distanza sarà calcolata usando un metodo planare (terra piatta) o geodetico (ellissoide).
|
| Risultato nome raster di accumulazione distanza | Il raster di accumulazione distanza contiene la distanza accumulativa per ogni cella da o verso l'origine di costo minore. Il raster di output è di tipo virgola mobile. Il nome del layer che verrà creato in I miei contenuti e aggiunto alla mappa. Il nome predefinito è basato sul nome dello strumento e sul nome del layer di input. Se il layer esiste già, verrà chiesto di fornire un altro nome. È possibile specificare il nome di una cartella in I miei contenuti in cui salvare il risultato usando la casella a discesa Salva risultato in. |
| Risultato nome di raster di direzione contraria (opzionale) | La back direction raster contiene la direzione calcolata in gradi. La direzione identifica la cella successiva seguendo il percorso più breve fino alla fonte più vicina evitando barriere. L'intervallo di valori è compreso tra 0 gradi e 360 gradi, con 0 riservato per le celle di origine. Verso est (destra) è di 90 e i valori aumentano in senso orario (180 è sud, 270 è ovest e 360 è nord). Il raster di output è di tipo virgola mobile. Il nome del layer che verrà creato in I miei contenuti e aggiunto alla mappa. Il nome predefinito è basato sul nome dello strumento e sul nome del layer di input. Se il layer esiste già, verrà chiesto di fornire un altro nome. È possibile specificare il nome di una cartella in I miei contenuti in cui salvare il risultato usando la casella a discesa Salva risultato in. |
| Risultato nome di raster di direzione all'origine (opzionale) | Il raster di direzione all'origine identifica la direzione della cella di origine con costo di accumulazione minore come un azimut in gradi. L'intervallo di valori è compreso tra 0 gradi e 360 gradi, con 0 riservato per le celle di origine. Verso est (destra) è di 90 e i valori aumentano in senso orario (180 è sud, 270 è ovest e 360 è nord). Il raster di output è di tipo virgola mobile. Il nome del layer che verrà creato in I miei contenuti e aggiunto alla mappa. Il nome predefinito è basato sul nome dello strumento e sul nome del layer di input. Se il layer esiste già, verrà chiesto di fornire un altro nome. È possibile specificare il nome di una cartella in I miei contenuti in cui salvare il risultato usando la casella a discesa Salva risultato in. |
| Risultato nome di raster di posizione all'origine (opzionale) | Il raster di posizione di origine è un output multibanda. La prima banda contiene un indice di riga e la seconda banda contiene un indice di colonna. Questi indici identificano la posizione della cella di origine che è lontana dalla distanza di costo accumulato minore, Il nome del layer che verrà creato in I miei contenuti e aggiunto alla mappa. Il nome predefinito è basato sul nome dello strumento e sul nome del layer di input. Se il layer esiste già, verrà chiesto di fornire un altro nome. È possibile specificare il nome di una cartella in I miei contenuti in cui salvare il risultato usando la casella a discesa Salva risultato in. |
Ambienti
Le impostazioni ambiente di analisi sono parametro aggiuntivi che influenzano i risultati dello strumento. È possibile accedere alle impostazioni di ambiente di analisi dello strumento cliccando l'icona dell'ingranaggio 
in cima al pannello degli strumenti.
Questo strumento onora gli Ambienti di analisi seguenti:
- Sistema di coordinate di output: specifica il sistema di coordinate di un layer di output.
- Estensione: specifica l'area da utilizzare per l'analisi.
- Snap raster: regola l'estensione dell'output in modo che corrisponda all'allineamento della cella del layer snap raster specificato.
- Dimensione cella: la dimensione della cella da utilizzare nel layer output.
- Maschera: specifica un layer maschera, dove solo le celle che ricadono all'interno dell'area di maschera saranno utilizzate per l'analisi.
- Fattore di processione parallelo: controlla il raster che elabora istanze CPU o GPU.
Strumenti simili e funzioni raster
Lo strumento Accumulazione Distanza calcola la distanza accumulata da ogni cella alle origini di input. Altri strumenti possono essere utili per la risoluzione di problemi simili.
Strumenti di analisi e funzioni raster di Map Viewer classico
Usare lo strumento Allocazione distanza o la funzione di raster Allocazione distanza se un output di servizio di immagine allocazione distanza è richiesto.
Accumulazione Distanza è disponibile anche come funzione raster.
Strumenti di analisi e funzioni raster di ArcGIS Pro
Gli strumenti di geoprocessing Accumulazione distanza e Allocazione distanza sono disponibili nella casella degli strumenti Spatial Analyst.
Gli strumenti di geoprocessing Accumulazione distanza e Allocazione distanza sono disponibili nella casella degli strumenti Raster Analysis.
Accumulazione distanza e Allocazione distanza sono disponibili come funzioni di raster.
Risorse per sviluppatori di ArcGIS Enterprise
Se si sta lavorando in ArcGIS REST API, usare le attività Distance Accumulation e Distance Allocation.
Se si sta lavorando in ArcGIS API for Python, usare distance_accumulation 
e distance_allocation dal modulo arcgis.raster.functions.gbl.