Disponible con una licencia de Spatial Analyst.
Resumen
Calcula, para cada celda, el origen más cercano según la distancia euclidiana.
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 Tipo de asignación de celdas predeterminado que la herramienta De polígono a ráster, que es el método de centro de la celda. 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 tanto no se representarán 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ños en relación con el tamaño de la celda de salida, es posible que solo algunos de ellos estén debajo de los centros de las celdas ráster de salida, lo que haría probablemente que la mayor parte de los otros se perdiera en el análisis.
Para evitar esta situación, como paso intermedio, podría rasterizar las entidades de entrada directamente con la herramienta De polígono a ráster y establecer un campo de Prioridad. A continuación, utilice la salida resultante como entrada de la herramienta de distancia que desee usar. Alternativamente, puede seleccionar un tamaño de celda pequeño 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.
El ráster de valor de entrada es útil si el ráster de entrada o los datos de origen de la entidad son un ráster derivado de una función que da como resultado uno o cero. Estas funciones pierden sus valores de zona originales asociados con las ubicaciones de la celda de origen. El ráster de valor de entrada puede restaurar estos valores o permitir el análisis de combinaciones adicionales de valores de zona dentro de las celdas de origen.
Si utiliza un ráster de valor de entrada, podría cambiar la configuración y los resultados de la salida de asignación euclidiana. No afectará la distancia euclidiana opcional ni los resultados de dirección.
Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente en los datasets mayores. El tema de ayuda Procesamiento en paralelo con Spatial Analyst contiene más detalles acerca de esta posibilidad y cómo configurarla.
Al utilizar el procesamiento en paralelo, se escriben datos temporales para administrar los lotes de datos a medida que se procesan. La ubicación de la carpeta temporal predeterminada será su unidad C local. Es posible controlar la ubicación de esta carpeta cambiando el valor de una variable de entorno del sistema denominada TempFolders y especificando la ruta de la carpeta que se desea usar (por ejemplo, E:\RasterCache). Si tiene privilegios de administrador en su equipo, también puede usar una clave de registro (por ejemplo, [HKEY_CURRENT_USER\SOFTWARE\ESRI\Desktop10.6\Raster]).
De forma predeterminada, esta herramienta usará el 50 por ciento de los núcleos disponibles. Si los datos de entrada tienen un tamaño inferior a 5.000 x 5.000 celdas, es posible que se utilicen menos núcleos. Es posible controlar el número de núcleos empleados por la herramienta, a través de la configuración de entorno de Factor de procesamiento en paralelo.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
EucAllocation (in_source_data, {maximum_distance}, {in_value_raster}, {cell_size}, {source_field}, {out_distance_raster}, {out_direction_raster}, {distance_method})| 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. Si el ráster de origen de entrada es de punto flotante, debe establecerse el {in_value_raster} y debe ser del tipo entero. El ráster de valores tendrá prioridad sobre cualquier configuración del {source_field}. | 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 |
in_value_raster (Opcional) | Ráster entero de entrada que identifica los valores de la zona que se deben utilizar para cada ubicación de origen de entrada. En cada ubicación de origen (celda o entidad), el valor definido por el {in_value_raster} se asignará a todas las celdas asignadas a la ubicación de origen para el cómputo. El ráster de valores tendrá prioridad sobre cualquier configuración para el {source_field}. | Raster Layer |
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 |
source_field (Opcional) | El campo que se utiliza para asignar los valores a las ubicaciones de origen. Debe ser de tipo entero. Si se ha establecido el {in_value_raster}, los valores de esa entrada tendrán prioridad sobre cualquier configuración para el {source_field}. | Field |
out_distance_raster (Opcional) | 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 Dataset |
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, a la que cada centro de celda se encuentra del centro de celda 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 |
distance_method (Opcional) | Determina si la distancia se calcula basándose en un método planar (Tierra plana) o geodésico (elipsoide).
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_allocation_raster | El ráster de asignación euclidiana de salida. Los valores de las celdas (zonas) identifican la ubicación del origen más cercano. El ráster de salida no es de tipo entero. | Raster |
Muestra de código
Ejemplo 1 de EucAllocation (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta EuclideanAllocation.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
eucAllocate = EucAllocation("observers", 50000, "elevation", 25, "FID",
"c:/sapyexamples/output/outeucdist",
"c:/sapyexamples/output/outeucdir")
eucAllocate.save("c:/sapyexamples/output/eucalloc")
Ejemplo 2 de EucAllocation (secuencia de comandos independiente)
Calcula, para cada celda, la zona de ubicación del origen más cercano en la distancia euclidiana.
# Name: EucAllocation_Ex_02.py
# Description: Calculates, for each cell, the zone of the closest
# source location in Euclidean distance.
# 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 = 50000
valRaster = "elevation"
cellSize = 25
sourceField = "FID"
optOutDist = "c:/sapyexamples/output/outeucdist02"
optOutDir = "c:/sapyexamples/output/outeucdir02"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute EucAllocation
eucAllocate = EucAllocation(inSource, maxDist, valRaster, cellSize,
sourceField, optOutDist, optOutDir)
# Save the output
eucAllocate.save("c:/sapyexamples/output/eucalloc02")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst