Dirección euclidiana (Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

Calcula, para cada celda, la dirección en grados hacia el origen más cercano.

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

Ilustración

Euclidean Direction illustration
Euc_Dir = EucDirection(Source_Ras)

Uso

Sintaxis

EucDirection (in_source_data, {maximum_distance}, {cell_size}, {out_distance_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_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

Valor de retorno

NombreExplicaciónTipo de datos
out_direction_raster

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

Ejemplo de código

Ejemplo 1 de EucDirection (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta EuclideanDirection.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucDirect = EucDirection("observers", 35000, 50, 
                            "c:/sapyexamples/output/optoutdist")
outEucDirect.save("c:/sapyexamples/output/eucoutdir")
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: EucDirection_Ex_02.py
# Description: Calculates the direction in degrees that each 
#              cell center is from the cell center of the 
#              closest 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
inSource = "observers.shp"
maxDist = 35000
cellSize = 50
optOutDistance = "c:/sapyexamples/output/optdistout"

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

# Execute EucDirections
outEucDirect = EucDirection(inSource, maxDist, cellSize, 
                            optOutDistance)

# Save the output 
outEucDirect.save("c:/sapyexamples/output/eucoutdir02")

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst
ArcGIS for Desktop Standard: Requiere Spatial Analyst
ArcGIS for Desktop Advanced: Requiere Spatial Analyst
9/11/2013