Résumé
Calcule la distance euclidienne à partir d’une seule source ou d’un ensemble de sources.
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 Raster Analysis . 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.
Syntaxe
arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})| Paramètre | 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) | Spécifie le calcul de la distance selon une méthode plane (terre plate) ou géodésique (ellipsoïde).
| 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 dérivée
| Nom | Explication | Type de données |
| outputDistanceRaster | Le raster de distance en sortie. | Couche raster |
| outputDirectionRaster | Le raster de direction en sortie. | Couche raster |
| outputBackDirectionRaster | Raster de direction d’antécédence en sortie. | Couche raster |
| outputAllocationRaster | Le raster d’allocation en sortie. | Couche raster |
Exemple de code
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")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
Informations de licence
- Basic: Requiert ArcGIS Image Server
- Standard: Requiert ArcGIS Image Server
- Advanced: Requiert ArcGIS Image Server
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?