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

Illustration de l’outil Calculer la distance

Utilisation

  • Cet outil du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise Lien vers Présentation de l’analyse dans ArcGIS Enterprise comportant un ArcGIS Image Server Lien vers Présentation de ArcGIS Image Server configuré pour Analyse raster Lien vers Configurer et déployer l’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

ÉtiquetteExplicationType 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).

  • PlanaireLe 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ésiqueLe 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

ÉtiquetteExplicationType 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

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})
NomExplicationType 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).

  • PlanarLe 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.
  • GeodesicLe 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

NomExplicationType 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)

Informations de licence

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

Rubriques connexes