Disponible con una licencia de Spatial Analyst.
Resumen
Calcula en grados, para cada celda, la dirección a la celda vecina por la ruta más corta, de vuelta al origen más cercano, a la vez que evita las barreras.
Uso
Los datos de origen de entrada pueden ser un ráster o una clase de entidad.
Los valores de salida están basado en la dirección de brújula (90 al este, 180 al sur, 270 al oeste y 360 al norte), con el 0 reservado para las celdas de origen.
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 un ráster de origen con las herramientas de extracción.
Cuando los datos de origen de entrada son una clase de entidades, las ubicaciones de origen se convierten internamente en un ráster antes de realizar el análisis.
Al utilizar datos de entidad 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 utiliza 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 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 entidad a ráster y establecer el parámetro Campo. 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 Tamaño de celda de salida se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro o el tamaño de celda del entorno, el tamaño de celda de salida predeterminado se determina según el tipo de dataset de entrada de la siguiente manera:
- Si el dataset de entrada es un ráster, se usa el tamaño de celda del dataset.
- Si el dataset de entrada es una entidad y se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se ha configurado un ráster de alineación, el tamaño de celda se calcula a partir de la anchura o la altura de la extensión dividido por 250, donde la extensión se encuentra en el Sistema de coordenadas de salida especificado en el entorno.
Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.
Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente a la referencia espacial de salida, se proyecta en función del Método de proyección de tamaño de celda seleccionado.
La extensión de procesamiento predeterminada para esta herramienta es Combinación de entradas. Se procesará la extensión combinada de ambos datasets de entrada.
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.7\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 que se aplican a esta herramienta.
Sintaxis
EucBackDirection(in_source_data, {in_barrier_data}, {maximum_distance}, {cell_size}, {distance_method})| Parámetro | Explicación | Tipo de datos |
in_source_data | Ubicaciones de origen de entrada. Un dataset de entidades o ráster que identifica las celdas o las ubicaciones para las cuales se calcula la dirección euclidiana hacia atrás 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 |
in_barrier_data (Opcional) | El dataset que define las barreras. Las barreras pueden definirse mediante un ráster entero o de punto flotante, o mediante una capa de entidades. | Raster Layer; Feature Layer |
maximum_distance (Opcional) | 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 del ráster de salida que se va a crear. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte su uso para obtener más detalles. | Analysis Cell Size |
distance_method (Opcional) | Especifica si la distancia se va a calcular basándose en un método planar (Tierra plana) o geodésico (elipsoide).
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_back_direction_raster | El ráster de dirección euclidiana hacia atrás de salida. El ráster de dirección hacia atrás contiene la dirección calculada en grados. La dirección identifica la siguiente celda por la ruta más corta, de vuelta al origen más cercano, a la vez que evita las barreras. 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 es de tipo flotante. | Raster |
Muestra de código
Ejemplo 1 de EucDirection (ventana de Python)
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta EuclideanBackDirection.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucBackDir = EucBackDirection("observers", "in_barriers", 35000, 50,
"GEODESIC")
outEucBackDir.save("c:/sapyexamples/output/eucoutbackdir.tif")
Ejemplo 2 de EucDirection (secuencia de comandos independiente)
Calcula la dirección en grados a la que se encuentra cada centro de celda desde el centro de celda del origen más cercano.
# Name: EucBackDirection_Ex_02.py
# Description: Calculates, for each cell, the direction,
# in degrees, to the neighboring cell along
# the shortest path back to the closest
# source while avoiding barriers.
# 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"
inBarriers = "rivers.tif"
maxDist = 35000
cellSize = 50
distMethod = "GEODESIC"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute EucDirections
outEucBackDir = EucBackDirection(inSource, inBarriers, maxDist,
cellSize, distMethod)
# Save the output
outEucBackDir.save("c:/sapyexamples/output/eucoutbackdir02.tif")
Entornos
- Auto ejecución
- Tamaño de celda
- Método de proyección de tamaño de celda
- Compresión
- Espacio de trabajo actual
- Extensión
- Transformaciones geográficas
- Máscara
- Palabra clave CONFIG de salida
- Sistema de coordenadas de salida
- Factor de procesamiento en paralelo
- Espacio de trabajo temporal
- Alinear ráster
- Tamaño de tesela
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst