Distance euclidienne (Spatial Analyst)

Niveau de licence :De baseStandardAvancé

Récapitulatif

Calcule pour chaque cellule la distance euclidienne par rapport à la source la plus proche.

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

Illustration

Illustration de l'outil Distance euclidienne
Euc_Dist = EucDistance(Source_Ras)

Utilisation

Syntaxe

EucDistance (in_source_data, {maximum_distance}, {cell_size}, {out_direction_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_direction_raster
(Facultatif)

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 de type entier.

Raster Dataset

Valeur renvoyée

NomExplicationType de données
out_distance_raster

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

Exemple de code

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucDistance = EucDistance("rec_sites.shp", 5000, 5, 
                             "c:/sapyexamples/output/EucDirOut")
outEucDistance.save("C:/sapyexamples/output/eucdist")
Deuxième exemple d'utilisation de l'outil EucDistance (script autonome)

Calcule la distance en ligne droite par rapport à la source la plus proche pour chaque cellule.

# Name: EucDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance to the nearest 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
inSourceData = "rec_sites.shp"
maxDistance = 4000
cellSize = 4
outDirectionRaster = "C:/sapyexamples/output/eucdirect"

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

# Execute EucDistance
outEucDistance = EucDistance(inSourceData, maxDistance, cellSize, outDirectionRaster)

# Save the output 
outEucDistance.save("C:/sapyexamples/output/eucdist")

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
9/13/2013