Disponible con una licencia de Spatial Analyst.
Resumen
Calcula, para cada celda, la distancia euclidiana hasta el origen más cercano.
Ilustración
Uso
Los datos de origen de entrada pueden ser un ráster o una clase de entidad.
Cuando los datos de origen de entrada son un ráster, el conjunto de celdas de origen consta de todas las celdas del ráster de origen que tengan valores válidos. Las celdas con valores NoData no se incluyen en el conjunto de origen. El valor 0 se considera un origen legítimo. Se puede crear fácilmente un ráster de origen mediante las herramientas de extracción.
Cuando los datos de origen de entrada son una clase de entidad, las ubicaciones de origen se convierten internamente en un ráster antes de realizar el análisis. La resolución del ráster se puede controlar con el parámetro de Tamaño de celda de salida o con el entorno de Tamaño de celda. Por defecto, la resolución se determinará por medio 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.
Al utilizar datos de entidad poligonal para los datos de origen de entrada, se debe tener cuidado con la manera en que el tamaño de celda de salida se maneja cuando es grueso en relación con los detalles presentes en la entrada El proceso de rasterización interno emplea el mismo método Tipo de asignación de celda predeterminado que la herramienta De polígono a ráster, que es CELL_CENTER. Esto significa que los datos no ubicados en el centro de la celda no se incluirán en la salida de origen rasterizada intermedia, y por lo tanto no se representan en los cálculos de distancia. Por ejemplo, si sus orígenes son una serie de polígonos pequeños, como huellas de edificios, que son pequeñas en relación con el tamaño de la celda de salida, es posible que solo algunos de ellos caigan debajo de los centros de las celdas ráster de salida, ocasionando aparentemente que la mayor parte de los otros se pierdan en el análisis.
Para evitar esta situación, como un paso intermedio, puede rasterizar las entidades de entrada directamente con la herramienta Polígono a ráster y establecer un campo de Prioridad, y utilizar la salida resultante como entrada para la herramienta de distancia. Alternativamente, puede seleccionar un tamaño de celda lo suficientemente pequeña para capturar la cantidad adecuada de detalle de las entidades de entrada.
La Distancia máxima se especifica en las mismas unidades de mapa que los datos de origen de entrada.
La asignación no es una salida disponible porque puede no haber información de punto flotante en los datos de origen. Si desea la salida de asignación, utilice la herramienta Asignación euclidiana, que puede generar las tres salidas (asignación, distancia y dirección) al mismo tiempo.
Si se estableció una Máscara en el entorno y las celdas que serán enmascaradas crearán una máscara en el origen, los cálculos euclidianos ocurrirán en las celdas de origen restantes. Las celdas de origen con máscaras no se considerarán en los cómputos. Las ubicaciones de estas celdas se asignarán como NoData en los rásteres de salida.
Los valores NoData creados por las celdas con máscaras se ignoran en los cálculos de las ubicaciones de celda sin origen. La distancia euclidiana de las celdas detrás de los valores NoData se calcula como si el valor NoData no estuviera presente. Cualquier ubicación de celdas asignada como NoData por la máscara en la superficie de entrada recibirá NoData en todos los rásteres de salida.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
EucDistance (in_source_data, {maximum_distance}, {cell_size}, {out_direction_raster})| Parámetro | Explicación | Tipo 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:
| 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
| Nombre | Explicación | Tipo 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 |
Muestra 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
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Análisis espacial
- ArcGIS Desktop Standard: Requiere Análisis espacial
- ArcGIS Desktop Advanced: Requiere Análisis espacial