Chemin optimal comme ligne (Analyse raster)

Synthèse

Calcule le chemin optimal depuis une source vers une destination en tant que ligne.

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS 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.

• L’outil Chemin optimal comme ligne permet d’obtenir un service d’entités linéaires en sortie qui enregistre le ou les chemins optimaux depuis les destinations jusqu’à la source la plus proche définie dans la zone de coûts cumulés ou dans la zone de distance euclidienne.

• Lorsque les données de destination en entrée correspondent à un raster, l’ensemble des cellules de destination englobe toutes les cellules du raster en entrée ou les entités de destination (Input raster or feature destination data) comprenant des valeurs autorisées. Les cellules associées à la valeur NoData ne figurent pas dans la source. La valeur zéro est une destination pertinente. Vous pouvez créer un raster de destination à l’aide des outils d’extraction.

• Lorsque vous utilisez des données d’entité pour les destinations en entrée, vous devez gérer la taille de cellule en sortie avec prudence, notamment si elle est grossière par rapport aux détails dans l’entrée. Un processus de tramage interne utilisant l’outil Feature to Raster (Entité vers raster) est appliqué. Cela signifie que les données ne figurant pas au centre de la cellule ne seront pas incluses dans la sortie de destination rasterisée intermédiaire ; elles ne seront donc pas représentées dans les calculs de distance. Si, par exemple, vos destinations sont représentées par une série de petits polygones, tels que des emprises de bâtiments, dont la taille est petite par rapport à la taille de cellule en sortie, il se peut que quelques-uns d’entre eux seulement apparaissent aux centres des cellules raster en sortie et que, vraisemblablement, la plupart des autres polygones soient perdus et exclus de l’analyse.

  Pour éviter cette situation, vous pouvez entre-temps effectuer la rasterisation des entités en entrée directement avec l’outil Entité vers raster et définir le paramètre Champ. Ensuite, utilisez la sortie en entrée dans l'outil de distance que vous souhaitez utiliser. Vous pouvez également sélectionner une petite taille de cellule pour capturer le nombre de détails approprié à partir des entités en entrée.

• Avant la génération d'un chemin optimal, l'un des outils suivants est généralement utilisé pour créer un raster d'accumulation de distance et un raster de direction arrière : Distance Accumulation (Accumulation de distance) ou Distance Allocation (Allocation de distance). Il s’agit d’entrées obligatoires pour générer un chemin optimal.

• Le chemin optimal créé peut être un chemin de flux basé sur le sens de circulation D8. Pour générer un chemin optimal de cette manière, utilisez un raster de sens de circulation D8 en entrée pour le paramètre Raster de direction arrière ou de sens de circulation en entrée. Vous devez également fournir un Input distance accumulation raster (Raster d’accumulation de distance en entrée) ; le Input distance accumulation raster (Raster d’accumulation de distance en entrée) n’est pas utilisé pour déterminer le chemin. Votre chemin sera le même que vous utilisiez un raster constant ou un modèle numérique de terrain (MNT) ; seule une valeur attributaire sur votre chemin sera différente. Reportez-vous à l’outil Direction de flux pour de plus amples informations sur les rasters de direction de flux D8.

• Le service d’entités en sortie comporte un champ nommé DestID, qui identifie la destination de chaque ligne.

• Contrairement à la plupart des autres outils d’analyse raster, l’outil Optimal Path As Line (Chemin optimal comme ligne) ignore les paramètres d’environnement suivants : Output Coordinate System (Système de coordonnées en sortie), Extent (Étendue), Cell Size (Taille de cellule) et Snap Raster (Raster de capture). Vous risquez de modifier considérablement la configuration du raster d’antécédence s’il a été rééchantillonné ou reprojeté, entraînant un chemin incorrect.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Données raster ou de destination d’entités en entrée	Jeu de classes d’entités ou raster identifiant les emplacements à partir desquels le chemin de plus faible coût cumulé est déterminé par rapport à la source de plus faible coût. Pour un raster, l’entrée doit être de type entier et être constituée de cellules qui possèdent des valeurs admises (zéro est une valeur valide). Les cellules restantes doivent avoir la valeur NoData. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Image Service; Feature Layer; String
Raster d’accumulation de distance en entrée	Le raster d’accumulation de distance est utilisé pour déterminer le chemin optimal entre les sources et les destinations. Le raster d’accumulation de distance est généralement créé avec l’outil Accumulation de distance ou Allocation de distance. Chaque cellule du raster d’accumulation de distance représente la distance de coût cumulée minimum sur une surface allant de chaque cellule à un ensemble de cellules source.	Raster Layer; Image Service; String
Raster de direction arrière ou de direction de flux en entrée	Le raster de direction d’antécédence contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules source. La direction plein Est (droite) est de 90 degrés et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).	Raster Layer; Image Service; String
Chemin optimal comme entité en sortie	Nom du service d’entités en sortie contenant les chemins optimaux.	String
Champ de destination (Facultatif)	Champ à utiliser pour obtenir des valeurs pour les emplacements de destination. Ce champ doit être un entier.	Field
Type de chemin (Facultatif)	Spécifie un mot-clé définissant la manière dont les valeurs et les zones des données de destination en entrée sont interprétées dans les calculs du chemin de coût. Chaque zone—Pour chaque zone des données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre dans le raster en sortie. Avec cette option, pour chaque zone, le chemin de plus faible coût commence à la cellule avec la pondération de distance de plus faible coût dans la zone. Il s’agit de l’option par défaut. Le moins coûteux—Pour toutes les cellules des données de destination en entrée, le chemin de plus faible coût est dérivé de la cellule contenant le chemin de plus faible coût minimal des chemins de coût vers les cellules source. Chaque cellule—Pour chaque cellule contenant des valeurs valides de données de destination en entrée, un moindre coût est déterminé et enregistré dans le raster en sortie. Avec cette option, chaque cellule de l’entrée est traitée séparément et un chemin de moindre coût est déterminé pour chaque cellule.	String
Créer des chemins de réseau (Facultatif)	Spécifie si des chemins complets, qui peuvent se superposer, depuis les destinations vers les sources, sont calculés, ou si des chemins de réseau non superposés sont créés. Désactivé : des chemins complets depuis les destinations vers les sources sont calculés et peuvent se superposer. Il s’agit de l’option par défaut. Activé : des chemins de réseau non superposés sont calculés.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Entité polyligne en sortie	Service d’entités en sortie correspondant aux chemins optimaux.	Couche d’entités

Python

arcpy.ra.OptimalPathAsLine(inputDestinationRasterOrFeatures, inputDistanceAccumulationRaster, inputBackDirectionRaster, outputPolylineName, {destinationField}, {pathType}, {createNetworkPaths})

Nom	Explication	Type de données
inputDestinationRasterOrFeatures	Jeu de classes d’entités ou raster identifiant les emplacements à partir desquels le chemin de plus faible coût cumulé est déterminé par rapport à la source de plus faible coût. Pour un raster, l’entrée doit être de type entier et être constituée de cellules qui possèdent des valeurs admises (zéro est une valeur valide). Les cellules restantes doivent avoir la valeur NoData. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Image Service; Feature Layer; String
inputDistanceAccumulationRaster	Le raster d’accumulation de distance est utilisé pour déterminer le chemin optimal entre les sources et les destinations. Le raster d’accumulation de distance est généralement créé avec l’outil Accumulation de distance ou Allocation de distance. Chaque cellule du raster d’accumulation de distance représente la distance de coût cumulée minimum sur une surface allant de chaque cellule à un ensemble de cellules source.	Raster Layer; Image Service; String
inputBackDirectionRaster	Le raster de direction d’antécédence contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules source. La direction plein Est (droite) est de 90 degrés et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).	Raster Layer; Image Service; String
outputPolylineName	Nom du service d’entités en sortie contenant les chemins optimaux.	String
destinationField (Facultatif)	Champ à utiliser pour obtenir des valeurs pour les emplacements de destination. Ce champ doit être un entier.	Field
pathType (Facultatif)	Spécifie un mot-clé définissant la manière dont les valeurs et les zones des données de destination en entrée sont interprétées dans les calculs du chemin de coût. EACH_ZONE—Pour chaque zone des données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre dans le raster en sortie. Avec cette option, pour chaque zone, le chemin de plus faible coût commence à la cellule avec la pondération de distance de plus faible coût dans la zone. Il s’agit de l’option par défaut. BEST_SINGLE—Pour toutes les cellules des données de destination en entrée, le chemin de plus faible coût est dérivé de la cellule contenant le chemin de plus faible coût minimal des chemins de coût vers les cellules source. EACH_CELL—Pour chaque cellule contenant des valeurs valides de données de destination en entrée, un moindre coût est déterminé et enregistré dans le raster en sortie. Avec cette option, chaque cellule de l’entrée est traitée séparément et un chemin de moindre coût est déterminé pour chaque cellule.	String
createNetworkPaths (Facultatif)	Spécifie si des chemins complets, qui peuvent se superposer, depuis les destinations vers les sources, sont calculés, ou si des chemins de réseau non superposés sont créés. DESTINATIONS_TO_SOURCES—Des chemins complets depuis les destinations vers les sources sont calculés et peuvent se superposer. Il s’agit de l’option par défaut. NETWORK_PATHS—Des chemins de réseau non superposés sont calculés.	Boolean

Sortie obtenue

Nom	Explication	Type de données
outputPolylineFeatures	Service d’entités en sortie correspondant aux chemins optimaux.	Couche d’entités

Exemple de code

Exemple 1 d’utilisation de l’outil Chemin optimal comme ligne (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil OptimalPathAsLine.

import arcpy

arcpy.ra.OptimalPathAsLine(
    "https://myserver/rest/services/destination/ImageServer", 
    "https://myserver/rest/services/accumulationraster/ImageServer", 
    "https://myserver/rest/services/backdirection/ImageServer", 
    "outpath")

Exemple 2 d’utilisation de l’outil Chemin optimal comme ligne (script autonome)

Calcule le chemin optimal entre une destination et une source.

#-------------------------------------------------------------------------------
# Name: OptimalPathAsLine_Ex_02.py
# Description: Calculates the optimal path from a source to a destination.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputDestinationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputAccumulationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costaccumulation/ImageServer'
inputDirectionLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backdirection/ImageServer'
outputName = 'outTravelPaths'


arcpy.ra.OptimalPathAsLine(inputDestinationLayer, inputAccumulationLayer,
                            inputDirectionLayer, outputName)

Environnements

Système de coordonnées en sortie

Informations de licence

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