Asignación euclidiana (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

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

Heredado:

Esta herramienta está obsoleta y se eliminará en una versión futura.

La herramienta Asignación de distancia proporciona una funcionalidad o rendimiento mejorados.

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

Ilustración

Ilustración de Asignación euclidiana
Euc_Alloc = EucAllocation(Source_Ras)

Uso

  • Los datos de origen de entrada pueden ser un ráster o una clase de entidad. La clase de entidad puede ser punto, línea o polígono.

  • 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 valor de 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 los 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 celda de salida, es posible que solo algunos queden caigan 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 paso intermedio, puede 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.

  • El valor de 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.

  • El parámetro 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 ningún ráster de alineación, el tamaño de celda se calcula a partir del valor más pequeño de anchura o altura de la extensión dividido por 250 en el que la extensión se encuentra en el sistema de coordenadas de salida especificado en el entorno.
  • Si el tamaño de celda se especifica mediante un valor numérico, la herramienta lo utilizará directamente para el ráster de salida.

    Si el tamaño de celda se especifica utilizando un dataset ráster, el parámetro mostrará 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 utilizará 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 de la referencia espacial de salida, se proyectará en función del valor de Método de proyección de tamaño de celda especificado.

  • La extensión de procesamiento predeterminada para esta herramienta es el valor de 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. Consulte el tema de ayuda Procesamiento en paralelo con Spatial Analyst para obtener 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\ArcGISPro\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 5000 x 5000 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.

  • Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster o datos de origen de entidad de entrada

Ubicaciones de origen de entrada.

Se trata de un ráster o entidad que identifica las celdas o ubicaciones que se utilizarán para calcular 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 parámetro Ráster de valor de entrada y debe ser de tipo entero. El ráster de valor tendrá prioridad sobre el ajuste del parámetro Campo de origen.

Raster Layer; Feature Layer
Distancia máxima
(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
Ráster de valor de entrada
(Opcional)

Ráster entero de entrada que identifica los valores de zona que se utilizarán para cada ubicación de origen de entrada.

En cada ubicación de origen (celda o entidad), el valor de Ráster de valor de entrada se asignará a todas las celdas asignadas a la ubicación de origen para el cómputo. El ráster de valor tendrá prioridad sobre el ajuste del parámetro Campo de origen.

Raster Layer
Tamaño de celda de salida
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más información.

Analysis Cell Size
Campo fuente
(Opcional)

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

Si se ha definido el parámetro Ráster de valor de entrada, los valores de esa entrada tendrán precedencia sobre el ajuste del parámetro Campo de origen.

Field
Ráster de coste de distancia de salida
(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
Ráster de dirección de salida
(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
Método de distancia
(Opcional)

Especifica si el cálculo se basará en un método planar (tierra plana) o geodésico (elipsoide).

  • PlanarEl cálculo de distancia se realizará sobre un plano plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada.
  • GeodésicaEl cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.
String
Datos de barrera de entidad o ráster de entrada
(Opcional)

El dataset que define las barreras.

Las barreras pueden definirse mediante un ráster entero o de punto flotante, o mediante una entidad de punto, de línea o de polígono.

Raster Layer; Feature Layer
Ráster de dirección hacia atrás de salida
(Opcional)

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 Dataset

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de asignación de salida

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

EucAllocation(in_source_data, {maximum_distance}, {in_value_raster}, {cell_size}, {source_field}, {out_distance_raster}, {out_direction_raster}, {distance_method}, {in_barrier_data}, {out_back_direction_raster})
NombreExplicaciónTipo de datos
in_source_data

Ubicaciones de origen de entrada.

Se trata de un ráster o entidad que identifica las celdas o ubicaciones que se utilizarán para calcular 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 parámetro in_value_raster y debe ser de tipo entero. El ráster de valor tendrá prioridad sobre el ajuste del parámetro source_field.

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
in_value_raster
(Opcional)

Ráster entero de entrada que identifica los valores de zona que se utilizarán para cada ubicación de origen de entrada.

En cada ubicación de origen (celda o entidad), el de valor de in_value_raster se asignará a todas las celdas asignadas a la ubicación de origen para el cómputo. El ráster de valor tendrá prioridad sobre el ajuste del parámetro source_field.

Raster Layer
cell_size
(Opcional)

Tamaño de celda del ráster de salida que se 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 de tamaño de celda del entorno si se ha especificado; en caso contrario, se utilizarán otras reglas para calcularlo a partir de las otras entadas. Consulte la sección sobre el uso para obtener más informació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 definido el parámetro in_value_raster, los valores de esa entrada tendrán precedencia sobre el ajuste del parámetro 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)

Especifica si el cálculo se basará en un método planar (tierra plana) o geodésico (elipsoide).

  • PLANAREl cálculo de distancia se realizará sobre un plano plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada.
  • GEODESICEl cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.
String
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 entidad de punto, de línea o de polígono.

Raster Layer; Feature Layer
out_back_direction_raster
(Opcional)

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 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

Muestra de código

Ejemplo 1 de EucAllocation (ventana de Python)

El siguiente script 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 (script 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"

# Execute EucAllocation
eucAllocate = EucAllocation(inSource, maxDist, valRaster, cellSize,
                             sourceField, optOutDist, optOutDir)

# Save the output 
eucAllocate.save("c:/sapyexamples/output/eucalloc02")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados