Calcular distancia (Análisis ráster)

Resumen

Calcula la distancia euclidiana desde un solo origen o un conjunto de orígenes.

Heredado:

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

Las herramientas Acumulación de distancia o Asignación de distancia proporcionan una funcionalidad o rendimiento mejorados.

Ilustración

Uso

• Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se ejecuta la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

  La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

• Un ejemplo de aplicación de esta herramienta es hallar la distancia desde cualquier ubicación a la ciudad más cercana.

• Cuando los datos de origen de entrada son un servicio de imágenes, 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.

• Cuando los datos de origen de entrada son un servicio de entidades, 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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster o entidades de origen de entrada	La capa que define los orígenes para calcular también la distancia. La capa puede ser un servicio de imágenes o un servicio de entidades. En el caso de un servicio de imágenes, el tipo de entrada puede ser de tipo entero o de punto flotante. En el caso de un servicio de entidades, la entrada puede ser un punto, una línea o un polígono.	Raster Layer; Image Service; Feature Layer; String
Nombre de distancia de salida	El nombre del servicio ráster de distancia de salida.	String
Distancia máxima (Opcional)	La distancia máxima a la que hacer el cálculo de salida. Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU.. Las unidades predeterminadas son los metros.	Linear Unit
Tamaño de celda de salida (Opcional)	Defina el tamaño de celda y las unidades del ráster de salida. Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU.. Las unidades predeterminadas son los metros.	Linear Unit
Nombre de dirección de salida (Opcional)	El nombre del servicio ráster de dirección de salida.	String
Nombre de asignación de salida (Opcional)	El nombre del servicio ráster de asignación de salida.	String
Campo de asignación (Opcional)	Un campo en la entrada de origen que contiene los valores que definen cada origen. Debe ser de tipo entero.	String
Método de distancia (Opcional)	Especifica si la distancia se va a calcular basándose en un método planar (Tierra plana) o geodésico (elipsoide). Planar—El cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. Geodésica—El cálculo de distancia se realizará en el elipsoide. Por lo tanto, independientemente de la proyección de entrada o salida, los resultados no cambian.	String
Ráster o entidades de barrera 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 capa de entidades.	Raster Layer; Image Service; Feature Layer; String
Nombre de dirección hacia atrás de salida (Opcional)	El nombre del servicio ráster de dirección hacia atrás de salida.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ráster de distancia de salida	El ráster de distancia de salida.	Raster Layer
Ráster de dirección de salida	El ráster de dirección de salida.	Raster Layer
Ráster de dirección hacia atrás de salida	El ráster de dirección hacia atrás de salida.	Raster Layer
Ráster de asignación de salida	El ráster de asignación de salida.	Raster Layer

Python

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})

Nombre	Explicación	Tipo de datos
inputSourceRasterOrFeatures	La capa que define los orígenes para calcular también la distancia. La capa puede ser un servicio de imágenes o un servicio de entidades. En el caso de un servicio de imágenes, el tipo de entrada puede ser de tipo entero o de punto flotante. En el caso de un servicio de entidades, la entrada puede ser un punto, una línea o un polígono.	Raster Layer; Image Service; Feature Layer; String
outputDistanceName	El nombre del servicio ráster de distancia de salida.	String
maximumDistance (Opcional)	La distancia máxima a la que hacer el cálculo de salida. Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet. Las unidades predeterminadas son los metros.	Linear Unit
outputCellSize (Opcional)	Defina el tamaño de celda y las unidades del ráster de salida. Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet. Las unidades predeterminadas son los metros.	Linear Unit
outputDirectionName (Opcional)	El nombre del servicio ráster de dirección de salida.	String
outputAllocationName (Opcional)	El nombre del servicio ráster de asignación de salida.	String
allocationField (Opcional)	Un campo en la entrada de origen que contiene los valores que definen cada origen. Debe ser de tipo entero.	String
distanceMethod (Opcional)	Especifica si la distancia se va a calcular basándose en un método planar (Tierra plana) o geodésico (elipsoide). Planar—El cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. Geodesic—El cálculo de distancia se realizará en el elipsoide. Por lo tanto, independientemente de la proyección de entrada o salida, los resultados no cambian.	String
inputBarrierRasterOrFeatures (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; Image Service; Feature Layer; String
outputBackDirectionName (Opcional)	El nombre del servicio ráster de dirección hacia atrás de salida.	String

Salida derivada

Nombre	Explicación	Tipo de datos
outputDistanceRaster	El ráster de distancia de salida.	Raster Layer
outputDirectionRaster	El ráster de dirección de salida.	Raster Layer
outputBackDirectionRaster	El ráster de dirección hacia atrás de salida.	Raster Layer
outputAllocationRaster	El ráster de asignación de salida.	Raster Layer

Muestra de código

Ejemplo 1 de CalculateDistance (ventana de Python)

En este ejemplo se calcula la distancia euclidiana desde un solo origen.

import arcpy
arcpy.ra.CalculateDistance('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           "outDistance", "5000", "10", "outDirection", "outAllocation", "siting")

Ejemplo 2 de CalculateDistance (script independiente)

En este ejemplo se calcula la distancia euclidiana desde un conjunto de orígenes.

# Name: CalculateDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance, direction and allocation
#              to the nearest source.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSourceData = 'https://MyPortal.esri.com/server/rest/services/Hosted/reccenter/ImageServer'
outDistanceName = "eucdistance"
maxDistance = "4000"
cellSize = "10"
outDirectionName = "eucdirect"
outAllocationName = "eurallocation"
allocationField = "dataid"


# Execute EucDistance
arcpy.ra.CalculateDistance(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
                           outAllocationName, allocationField)

Entornos

Tamaño de celda, Extensión, Máscara, Sistema de coordenadas de salida, Pirámide, Alinear ráster

Información de licenciamiento

• Basic: Requiere ArcGIS Image Server
• Standard: Requiere ArcGIS Image Server
• Advanced: Requiere ArcGIS Image Server