Resumen
Calcula, para cada celda, la componente horizontal o vertical en una distancia en pendiente descendente, siguiendo las rutas del flujo, hasta las celdas de un curso de agua hacia el que fluyen. En el caso de varias rutas del flujo, se puede calcular la distancia de flujo mínima, media ponderada o máxima.
Si se proporciona un ráster de dirección de flujo opcional, las direcciones de pendiente descendente se limitarán a aquellas definidas por el ráster de dirección del flujo de entrada.
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. Esta herramienta no admite capas o datos ráster locales.
Para limitar las direcciones descendentes a lo largo de las cuales se mide la distancia del flujo, proporcione un ráster de dirección del flujo de entrada opcional que se pueda derivar utilizando la herramienta Dirección del flujo. Elija entre los modelos de flujo D8, D-Infinity (DINF) y Dirección del flujo múltiple (MFD) cuando genere un ráster de dirección del flujo de entrada opcional. Utilice el Tipo de dirección del flujo de entrada para especificar el método que se utilizó cuando se creó el ráster de dirección del flujo.
Si se proporciona un ráster de dirección del flujo de entrada opcional, se recomienda que dicho ráster se cree utilizando la herramienta Dirección del flujo y utilizando el mismo ráster de superficie de entrada que proporcione a la herramienta Distancia de flujo.
Si este ráster de superficie de entrada no presenta ningún sumidero, las mediciones de distancia se realizan en celdas de curso de agua representadas por el ráster de curso de agua de entrada.
Si este ráster de superficie de entrada presenta sumideros, algunas rutas de flujo pueden terminarse antes si fluyen hacia los sumideros antes de alcanzar cursos de agua. En tal caso, las mediciones de distancia de flujo para estas celdas se calculan solo hasta las celdas de sumidero hacia las que fluyen.
Cuando la herramienta se ejecuta sin un ráster de dirección de flujo opcional, la distancia de flujo se evalúa, considerando todas las rutas de flujo de pendiente descendente posibles desde cada celda hasta las celdas de un curso de agua hacia las que fluyen.
Cuando la herramienta se ejecuta con un ráster de dirección del flujo D8 opcional, solo hay una ruta de flujo de pendiente descendente posible desde todas las celdas hasta una celda del curso de agua, y la distancia de flujo se mide a lo largo de esa única ruta de flujo.
Se recomienda crear un ráster de curso de agua de entrada utilizando el mismo ráster de superficie de entrada proporcionado como entrada a la herramienta. Si dispone de una licencia de extensión Spatial Analyst disponible, puede crear rásteres de curso de agua desde un ráster de superficie de entrada con las herramientas Dirección del flujo, Acumulación del flujo y Evaluación condicional, respectivamente. Si desea utilizar cursos de agua desde otras fuentes de datos, para obtener los mejores resultados, debería grabarlos primero en el ráster de superficie de entrada y ejecutar a continuación la herramienta Distancia de flujo.
Si existen varias rutas de flujo desde cada celda a otras celdas del curso de agua hacia las que fluyen, use Tipo de estadísticas para computar la distancia de flujo mínima, media ponderada o máxima.
Si tan solo existe una única ruta de flujo desde cada celda a otra celda del curso de agua, todos los tipos de estadísticas generarán el mismo resultado.
Sintaxis
arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})| Parámetro | Explicación | Tipo de datos |
inputStreamRaster | El ráster de entrada que define la red de curso de agua. | Raster Layer; Image Service; String |
inputSurfaceRaster | Ráster de entrada que representa una superficie continua. | Raster Layer; Image Service; String |
outputName | El nombre del servicio ráster de distancia de flujo de salida. El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre. | String |
inputFlowDirectionRaster (Opcional) | Ráster de entrada que muestra la dirección del flujo de cada celda. Si se proporciona un ráster de dirección de flujo opcional, las direcciones de pendiente descendente se limitarán a aquellas definidas por las direcciones del flujo de entrada. El ráster de dirección del flujo se puede crear utilizando los métodos D8, MFD o DINF. Use el parámetro flowDirectionType para especificar el método utilizado al crear el ráster de dirección de flujo. | Raster Layer; Image Service; String |
distanceType (Opcional) | El tipo de distancia que se calculará.
| String |
flowDirectionType (Opcional) | Especifica el tipo del ráster de dirección del flujo de entrada.
| String |
statisticsType (Opcional) | Determina el tipo de estadísticas usadas para calcular la distancia del flujo a lo largo de varias rutas de flujo. Si tan solo existe una única ruta de flujo desde cada celda a otra celda del curso de agua, todos los tipos de estadísticas generarán el mismo resultado.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| outputRaster | El ráster de salida. | Capa ráster |
Muestra de código
En este ejemplo se calcula la distancia de flujo horizontal de pendiente descendente mínima hasta una celda del ráster de curso de agua.
import arcpy
arcpy.FlowDistance_ra("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")En este ejemplo se calcula la distancia de flujo vertical de pendiente descendente mínima hasta una celda del ráster de curso de agua.
#---------------------------------------------------------------------------
# Name: FlowDistance_example02.py
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inStreams = "https://myserver/rest/services/streams/ImageServer"
inSurface = "https://myserver/rest/services/elevation_fill/ImageServer"
outputFlowDistance = "outFlowDistanceVertical2"
inFlowDirection = ""
distanceType = "VERTICAL"
# Execute Flow Distance raster analysis tool
arcpy.FlowDistance_ra(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server