Direction arrière euclidienne (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule pour chaque cellule la direction (en degrés) vers la cellule voisine le long du chemin le plus court pour revenir à la source la plus proche en évitant les interruptions.

Héritage :

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

L’outil Accumulation de distance fournit des fonctions ou performances optimisées.

En savoir plus sur l’analyse de la distance euclidienne

Utilisation

  • Les données source en entrée peuvent être une classe d’entités ou un raster. La classe d’entités peut être ponctuelle, linéaire ou surfacique.

  • Les valeurs en sortie sont basées sur les directions de la boussole (90 à l’est, 180 au sud, 270 à l’ouest et 360 au nord). Les cellules sources ont la valeur 0.

  • Lorsque les données source en entrée correspondent à un raster, 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. Vous pouvez créer un raster source à l’aide des outils d’extraction.

  • Lorsque les données source en entrée correspondent à une classe d’entités, les emplacements source sont convertis en raster en interne avant l’analyse.

  • Lorsque vous utilisez des données d’entité pour les données source en entrée, vous devez traiter la taille de cellule en sortie avec prudence si elle est grossière par rapport au détail dans l’entrée. Le processus de rastérisation interne utilise la même valeur par défaut Cell assignment type (Type d’attribution de cellule) que l’outil Entité vers raster, à savoir la méthode Centre de cellule. Cela signifie que les données ne figurant pas au centre de la cellule ne seront pas incluses dans la sortie source rastérisée intermédiaire ; elles ne seront donc pas représentées dans les calculs de distance. Par exemple, si les sources 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 de ces polygones 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 rastérisation des entités en entrée directement avec l’outil Entité vers raster et définir le paramètre Field (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.

  • La valeur Maximum distance (Distance maximale) est spécifiée dans les mêmes unités cartographiques que les données source en entrée.

  • Le paramètre Output cell size (Taille de cellule en sortie) peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, elle est dérivée de l’environnement Cell Size (Taille de cellule), s’il est spécifié. Si la taille de cellule du paramètre ou la taille de cellule de l’environnement n’ont pas été spécifiées, la taille de cellule en sortie par défaut est déterminée en fonction du type de jeu de données en entrée de la façon suivante :

    • Si le jeu de données en entrée est un raster, la taille de cellule du jeu de données est utilisée.
    • Si le jeu de données en entrée est une entité en entrée et si l’environnement Snap Raster (Raster de capture) est défini, la taille de cellule du raster de capture est utilisée. Si aucun raster de capture n’est défini, la taille de cellule résulte de la division par 250 de la largeur ou de la hauteur la plus petite (parmi les deux) de l’étendue spécifiée dans le système de coordonnées en sortie de l’environnement.
  • Si la taille de cellule est spécifiée à l’aide d’une valeur numérique, l’outil l’utilise directement pour le raster en sortie.

    Si la taille de cellule est spécifiée à l’aide d’un jeu de données raster, le paramètre affiche le chemin du jeu de données raster au lieu de la valeur de la taille de cellule. La taille de cellule de ce jeu de données raster sera utilisée directement dans l’analyse, à condition que la référence spatiale du jeu de données soit la même que la référence spatiale en sortie. Si la référence spatiale du jeu de données est différente de la référence spatiale en sortie, elle sera projetée en fonction de la valeur Cell Size Projection Method (Méthode de projection de la taille de cellule) spécifiée.

  • L’étendue de traitement par défaut pour cet outil est la valeur Union of Inputs (Union des entrées). L’étendue combinée des deux jeux de données en entrée est traitée.

  • Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Pour plus d’informations concernant cette fonctionnalité et sa configuration, consultez la rubrique d’aide Traitement parallèle avec Spatial Analyst.

    Lorsque vous utilisez le traitement parallèle, les données temporaires sont écrites pour gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque C:. Vous pouvez contrôler l’emplacement de ce dossier en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du dossier à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administrateur sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pour cent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisés peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l’environnement Facteur de traitement parallèle.

  • Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

ÉtiquetteExplicationType de données
Données raster ou d’entités sources en entrée

Emplacement des sources en entrée.

Il s’agit d’un raster ou d’un jeu de classes d’entités qui identifie les cellules ou les emplacements par rapport auxquels la direction arrière euclidienne pour chaque emplacement de cellule en sortie est calculée.

Pour les rasters, le type d'entrée peut être entier ou à virgule flottante.

Raster Layer; Feature Layer
Données raster ou d’entités interruptions en entrée
(Facultatif)

Jeu de données qui définit les interruptions.

Les interruptions peuvent être définies par un entier ou un raster à virgule flottante, ou par une entité ponctuelle, linéaire ou surfacique.

Raster Layer; Feature Layer
Distance maximale
(Facultatif)

Le seuil que les valeurs de distance cumulée ne peuvent pas dépasser.

Si une valeur de distance euclidienne cumulée dépasse cette valeur, la valeur en sortie de l'emplacement de cellule sera NoData.

La distance par défaut va jusqu'à la bordure du raster en sortie.

Double
Taille de cellule en sortie
(Facultatif)

Taille de cellule du raster en sortie à créer.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus.

Analysis Cell Size
Méthode de distance
(Facultatif)

Indique si la distance est 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 est effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster de direction arrière en sortie

Raster de direction arrière euclidienne en sortie.

Le raster de direction arrière contient la direction calculée, en degrés. La direction identifie la cellule suivante le long du chemin de retour le plus court vers la source la plus proche tout en évitant les interruptions.

La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Le raster en sortie est de type entier.

Raster

EucBackDirection(in_source_data, {in_barrier_data}, {maximum_distance}, {cell_size}, {distance_method})
NomExplicationType de données
in_source_data

Emplacement des sources en entrée.

Il s’agit d’un raster ou d’un jeu de classes d’entités qui identifie les cellules ou les emplacements par rapport auxquels la direction arrière euclidienne pour chaque emplacement de cellule en sortie est calculée.

Pour les rasters, le type d'entrée peut être entier ou à virgule flottante.

Raster Layer; Feature Layer
in_barrier_data
(Facultatif)

Jeu de données qui définit les interruptions.

Les interruptions peuvent être définies par un entier ou un raster à virgule flottante, ou par une entité ponctuelle, linéaire ou surfacique.

Raster Layer; Feature Layer
maximum_distance
(Facultatif)

Le seuil que les valeurs de distance cumulée ne peuvent pas dépasser.

Si une valeur de distance euclidienne cumulée dépasse cette valeur, la valeur en sortie de l'emplacement de cellule sera NoData.

La distance par défaut va jusqu'à la bordure du raster en sortie.

Double
cell_size
(Facultatif)

Taille de cellule du raster en sortie à créer.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus.

Analysis Cell Size
distance_method
(Facultatif)

Indique si la distance est 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 est effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.
String

Valeur renvoyée

NomExplicationType de données
out_back_direction_raster

Raster de direction arrière euclidienne en sortie.

Le raster de direction arrière contient la direction calculée, en degrés. La direction identifie la cellule suivante le long du chemin de retour le plus court vers la source la plus proche tout en évitant les interruptions.

La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).

Le raster en sortie est de type entier.

Raster

Exemple de code

Exemple 1 d’utilisation de la fonction EucDirection (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction EuclideanBackDirection.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucBackDir = EucBackDirection("observers", "in_barriers", 35000, 50, 
                            "GEODESIC")
outEucBackDir.save("c:/sapyexamples/output/eucoutbackdir.tif")
Exemple 2 d’utilisation de la fonction EucDirection (script autonome)

Calculer la direction, en degrés, de chaque centre de cellule par rapport au centre de cellule de la source la plus proche.

# Name: EucBackDirection_Ex_02.py
# Description: Calculates, for each cell, the direction,
#              in degrees, to the neighboring cell along
#              the shortest path back to the closest
#              source while avoiding barriers.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSource = "observers.shp"
inBarriers = "rivers.tif"
maxDist = 35000
cellSize = 50
distMethod = "GEODESIC"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute EucDirections
outEucBackDir = EucBackDirection(inSource, inBarriers, maxDist,
                            cellSize, distMethod)

# Save the output 
outEucBackDir.save("c:/sapyexamples/output/eucoutbackdir02.tif")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes