Calculer la distance (Analyseur raster)

Synthèse

Calcule la distance euclidienne à partir d’une seule source ou d’un ensemble de sources.

Conseil :

Les outils Accumulation de distance ou Allocation de distance fournissent des fonctions ou des performances améliorées.

Illustration

Utilisation

• Cet outil du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise comportant un ArcGIS Image Server configuré pour Analyse raster . Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

  La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Make Image Server Layer (Créer une couche de serveur d’imagerie). La couche d’entités en entrée peut être une couche du portail, ou une URI ou une URL d’un service d’entités. Cet outil ne prend pas en charge les données raster ou les couches locales. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, il est recommandé d’utiliser les couches de votre portail en entrée.

• Un exemple d’application de cet outil est la recherche de la distance entre un emplacement et la ville la plus proche.

• Lorsque les données source en entrée correspondent à un service d’imagerie, l’ensemble des cellules source englobe toutes les cellules du raster source comprenant des valeurs valides. Les cellules associées à la valeur NoData ne figurent pas dans la source. La valeur 0 est considérée comme une source normale.

• Lorsque les données source en entrée correspondent à un service d’entités, les emplacements source sont convertis en interne en raster avant l’analyse. La résolution du raster peut être contrôlée à l'aide du paramètre Taille de cellule en sortie ou de l'environnement Taille de cellule. Par défaut, la résolution est déterminée par la valeur la plus petite entre la largeur et la hauteur de l'étendue de l'entité en entrée, dans la référence spatiale en entrée, divisée par 250.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités ou raster source en entrée	Couche qui définit les sources sur lesquelles calculer la distance. La couche peut être un service d’imagerie ou un service d’entités. Pour le service d’imagerie, le type en entrée peut être entier ou à virgule flottante. Pour le service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Image Service; Feature Layer; String
Nom de distance en sortie	Nom du service raster de distance en sortie.	String
Distance maximale (Facultatif)	Distance de calcul maximale. Les unités peuvent être les kilomètres, les mètres, les miles, les yards ou les pieds. Les unités par défaut sont les mètres.	Linear Unit
Taille de cellule en sortie (Facultatif)	Définissez la taille de cellule et les unités pour le raster en sortie. Les unités peuvent être les kilomètres, les mètres, les miles, les yards ou les pieds. Les unités par défaut sont les mètres.	Linear Unit
Nom de la feuille de route en sortie (Facultatif)	Nom du service raster de la feuille de route en sortie.	String
Nom d’allocation en sortie (Facultatif)	Nom du service raster de l’allocation en sortie.	String
Champ d’allocation (Facultatif)	Champ dans l’entrée source qui contient les valeurs définissant chaque source. La valeur doit être de type entier.	String
Méthode de distance (Facultatif)	Indique si la distance doit être calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Planaire—Le calcul de la distance est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s’agit de l’option par défaut. Géodésique—Le calcul de la distance sera effectué sur l’ellipsoïde. Par conséquent, les résultats restent inchangés quelle que soit la projection en entrée ou en sortie.	String
Input Barrier Raster or Features (Entités ou raster d’interruption en entrée) (Facultatif)	Jeu de données définissant les interruptions. Les interruptions peuvent être définies par un raster d’entiers ou à virgule flottante, ou par une couche d’entités.	Raster Layer; Image Service; Feature Layer; String
Output Back Direction Name (Nom de la direction d’antécédence en sortie) (Facultatif)	Nom du service raster de direction d’antécédence en sortie.	String

Sortie obtenue

Étiquette	Explication	Type de données
Raster de distance en sortie	Raster de distance en sortie.	Raster Layer
Raster de direction en sortie	Le raster de direction en sortie.	Raster Layer
Output Back Direction Raster (Raster de direction d’antécédence en sortie)	Raster de direction d’antécédence en sortie.	Raster Layer
Raster d’allocation en sortie	Le raster d'allocation en sortie.	Raster Layer

Python

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})

Nom	Explication	Type de données
inputSourceRasterOrFeatures	Couche qui définit les sources sur lesquelles calculer la distance. La couche peut être un service d’imagerie ou un service d’entités. Pour le service d’imagerie, le type en entrée peut être entier ou à virgule flottante. Pour le service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Image Service; Feature Layer; String
outputDistanceName	Nom du service raster de distance en sortie.	String
maximumDistance (Facultatif)	Distance de calcul maximale. Les unités peuvent être les kilomètres, les mètres, les miles, les yards ou les pieds. Les unités par défaut sont les mètres.	Linear Unit
outputCellSize (Facultatif)	Définissez la taille de cellule et les unités pour le raster en sortie. Les unités peuvent être les kilomètres, les mètres, les miles, les yards ou les pieds. Les unités par défaut sont les mètres.	Linear Unit
outputDirectionName (Facultatif)	Nom du service raster de la feuille de route en sortie.	String
outputAllocationName (Facultatif)	Nom du service raster de l’allocation en sortie.	String
allocationField (Facultatif)	Champ dans l’entrée source qui contient les valeurs définissant chaque source. La valeur doit être de type entier.	String
distanceMethod (Facultatif)	Indique si la distance doit être calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Planar—Le calcul de la distance est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s’agit de l’option par défaut. Geodesic—Le calcul de la distance sera effectué sur l’ellipsoïde. Par conséquent, les résultats restent inchangés quelle que soit la projection en entrée ou en sortie.	String
inputBarrierRasterOrFeatures (Facultatif)	Jeu de données définissant les interruptions. Les interruptions peuvent être définies par un raster d’entiers ou à virgule flottante, ou par une couche d’entités.	Raster Layer; Image Service; Feature Layer; String
outputBackDirectionName (Facultatif)	Nom du service raster de direction d’antécédence en sortie.	String

Sortie obtenue

Nom	Explication	Type de données
outputDistanceRaster	Raster de distance en sortie.	Raster Layer
outputDirectionRaster	Le raster de direction en sortie.	Raster Layer
outputBackDirectionRaster	Raster de direction d’antécédence en sortie.	Raster Layer
outputAllocationRaster	Le raster d'allocation en sortie.	Raster Layer

Exemple de code

Exemple 1 d'utilisation de l'outil CalculateDistance (fenêtre Python)

Cet exemple calcule la distance euclidienne à partir d’une seule source.

import arcpy
arcpy.CalculateDistance_ra('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           "outDistance", "5000", "10", "outDirection", "outAllocation", "siting")

Exemple 2 d'utilisation de l'outil CalculateDistance (script autonome)

Cet exemple calcule la distance euclidienne à partir d’un ensemble de sources.

# Name: CalculateDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance, direction and allocation
#              to the nearest source.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSourceData = 'https://MyPortal.esri.com/server/rest/services/Hosted/reccenter/ImageServer'
outDistanceName = "eucdistance"
maxDistance = "4000"
cellSize = "10"
outDirectionName = "eucdirect"
outAllocationName = "eurallocation"
allocationField = "dataid"


# Execute EucDistance
arcpy.CalculateDistance_ra(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
                           outAllocationName, allocationField)

Environnements

Taille de cellule, Étendue, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Cas particuliers

Informations de licence

• Basic: Nécessite ArcGIS Image Server
• Standard: Nécessite ArcGIS Image Server
• Advanced: Nécessite ArcGIS Image Server