Resumen
Calcula la distancia euclidiana desde un solo origen o un conjunto de orígenes.
Ilustración
Uso
Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise que tiene un ArcGIS Image Server configurado para Raster Analysis . Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y tiene lugar el procesamiento 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.
Sintaxis
arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})
Parámetro | 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. Las unidades pueden ser kilómetros, metros, millas, yardas o pies. La unidad predeterminada es el metro. | Linear Unit |
outputCellSize (Opcional) | Defina el tamaño de celda y las unidades del ráster de salida. Las unidades pueden ser kilómetros, metros, millas, yardas o pies. La unidad predeterminada es el metro. | 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).
| 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. | Capa ráster |
outputDirectionRaster | El ráster de dirección de salida. | Capa ráster |
outputBackDirectionRaster | El ráster de dirección hacia atrás de salida. | Capa ráster |
outputAllocationRaster | El ráster de asignación de salida. | Capa ráster |
Muestra de código
En este ejemplo se calcula la distancia euclidiana desde un solo origen.
import arcpy
arcpy.CalculateDistance_ra('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
"outDistance", "5000", "10", "outDirection", "outAllocation", "siting")
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.CalculateDistance_ra(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
outAllocationName, allocationField)
Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server