Asignación euclidiana (Spatial Analyst)

Resumen

Calcula, para cada celda, el origen más cercano según la distancia euclidiana.

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

Ilustración

Euclidean Allocation illustration
Euc_Alloc = EucAllocation(Source_Ras)

Uso

Sintaxis

EucAllocation (in_source_data, {maximum_distance}, {in_value_raster}, {cell_size}, {source_field}, {out_distance_raster}, {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.

Si el ráster de origen de entrada es de punto flotante, se debe establecer el {in_value_raster} y debe ser del tipo entero. El ráster de valores tendrá precedencia 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á precedencia sobre cualquier configuración del {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:

  • 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
source_field
(Opcional)

El campo que se utiliza para asignar los valores a las ubicaciones de origen. Debe ser de tipo entero.

Si el {in_value_raster} se ha establecido, los valores de esa entrada tendrán precedencia 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, 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_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

Ejemplo 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

Temas relacionados

Información de licencia

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

7/11/2012