Direction euclidienne (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Calcule pour chaque cellule la direction, en degrés, par rapport à la source la plus proche.

Pour en savoir plus sur l'analyse d'une distance euclidienne

Illustration

Illustration de l'outil Direction euclidienne
Euc_Dir = EucDirection(Source_Ras)

Utilisation

Syntaxe

EucDirection (in_source_data, {maximum_distance}, {cell_size}, {out_distance_raster})
ParamètreExplicationType de données
in_source_data

Emplacement des sources en entrée.

Un raster ou un jeu de classes d'entités identifie les cellules ou les emplacements par rapport auxquels la distance 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
maximum_distance
(Facultatif)

Définit 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 des cellules qui sera utilisée pour la création du raster en sortie.

Il s'agit de la valeur définie dans l'environnement, si l'environnement est défini de façon explicite. Si elle n'est pas définie dans l'environnement, la taille de cellule par défaut dépend du fait que les données source en entrée correspondent à un raster ou à une entité, comme suit :

  • Si la source est un raster, la sortie aura la même taille de cellule.
  • Si la source est une entité, la sortie aura une taille de cellule déterminée par la valeur la plus faible 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.

Analysis Cell Size
out_distance_raster
(Facultatif)

Raster de distance euclidienne en sortie.

Le raster de distance identifie, pour chaque cellule, la distance euclidienne de la cellule source la plus proche, du jeu de cellules source le plus proche ou de l'emplacement source le plus proche.

Le raster en sortie est de type virgule flottante.

Raster Dataset

Valeur renvoyée

NomExplicationType de données
out_direction_raster

Raster de direction euclidienne en sortie.

Le raster de direction contient la direction calculée, en degrés, de chaque centre de cellule par rapport au centre de cellule source le plus proche.

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 un entier.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil EucDirection (fenêtre Python)

Le script dans la fenêtre Python ci-après explique comment utiliser l'outil EuclideanDirection.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucDirect = EucDirection("observers", 35000, 50, 
                            "c:/sapyexamples/output/optoutdist")
outEucDirect.save("c:/sapyexamples/output/eucoutdir")
Deuxième exemple d'utilisation de l'outil EucDirection (script autonome)

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

# Name: EucDirection_Ex_02.py
# Description: Calculates the direction in degrees that each 
#              cell center is from the cell center of the 
#              closest source.
# 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"
maxDist = 35000
cellSize = 50
optOutDistance = "c:/sapyexamples/output/optdistout"

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

# Execute EucDirections
outEucDirect = EucDirection(inSource, maxDist, cellSize, 
                            optOutDistance)

# Save the output 
outEucDirect.save("c:/sapyexamples/output/eucoutdir02")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst
5/10/2014