Distancia euclidiana (Spatial Analyst)

Resumen

Calcula, para cada celda, la distancia euclidiana hasta el origen más cercano.

Más información acerca del análisis de distancia euclidiana

Ilustración

Euclidean Distance illustration
Euc_Dist = EucDistance(Source_Ras)

Uso

Sintaxis

EucDistance (in_source_data, {maximum_distance}, {cell_size}, {out_direction_raster})
ParámetroExplicaciónTipo de datos
in_source_data

Ubicaciones de origen de entrada.

Esto es un dataset de entidades o ráster que identifica las celdas o las ubicaciones para las cuales se calcula la distancia euclidiana de cada ubicación de celda de salida.

Para los rásteres, el tipo de entrada puede ser de tipo entero o punto flotante.

Raster Layer | Feature Layer
maximum_distance
(Opcional)

Define el umbral que los valores de distancia acumulada no pueden superar.

Si un valor de distancia euclidiana acumulada supera este valor, el valor de salida de la ubicación de la celda será NoData.

La distancia predeterminada es hasta el borde del ráster de salida.

Double
cell_size
(Opcional)

El tamaño de celda con el que se creará el ráster de salida.

Esto será el valor del entorno si está establecido explícitamente. Si no se encuentra establecido en el entorno, el tamaño de celda predeterminado dependerá de si los datos de origen de entrada son un ráster o una entidad, como se ilustra a continuación:

  • Si el origen es un ráster, la salida tendrá el mismo tamaño de la celda.
  • Si el origen es una entidad, la salida tendrá un tamaño de celda determinado por el valor más bajo del ancho o la altura de la extensión de las entidades de entrada, en la referencia espacial de entrada, dividido por 250.

Analysis Cell Size
out_direction_raster
(Opcional)

Ráster de salida de dirección euclidiana.

El ráster de dirección contiene la dirección calculada, en grados, cada centro de celdas pertenece al centro de celdas de origen más próximo.

El rango de valores es de 0 grados hasta 360 grados, con el 0 reservado para las celdas de origen. Hacia el este (derecha) es 90 y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).

El ráster de salida no es de tipo entero.

Raster Dataset

Valor de retorno

NombreExplicaciónTipo de datos
out_distance_raster

Ráster de distancia euclidiana de salida.

El ráster de distancia identifica, para cada celda, la distancia euclidiana hasta la celda de origen más próxima, el conjunto de celdas de origen o la ubicación del origen.

El ráster de salida es de tipo de punto flotante.

Raster

Ejemplo de código

Ejemplo 1 de EucDistance (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta 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")
Ejemplo 2 de EucDistance (secuencia de comandos independiente)

Calcula, para cada celda, la distancia en línea recta hasta el origen más cercano.

# 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")

Entornos

Temas relacionados

Información de licencia

ArcView: Requiere Análisis espacial
ArcEditor: Requiere Análisis espacial
ArcInfo: Requiere Análisis espacial

7/11/2012