Calculer la distance (Analyse raster)

Synthèse

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

Héritage :

Cet outil est obsolète et sera retiré dans une version ultérieure.

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 de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS EnterpriseArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

    La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la 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 correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Cet outil ne prend pas en charge les couches ou données raster locales. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais 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 valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains).

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 valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Yards (Yards internationaux), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains), US Survey Yards (Yards d'arpentage américains) et US Survey Feet (Pieds d’arpentage américains).

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 valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet.

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 valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards et Feet.

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.ra.CalculateDistance('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.ra.CalculateDistance(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