Distancia de flujo (Análisis de ráster)

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

Ilustración de la herramienta Distancia de flujo

Uso

  • Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise Enlace a información sobre el análisis en el portal de ArcGIS Enterprise que tiene un ArcGIS Image Server enlace a Qué es ArcGIS Image Server configurado para Raster Analysis Enlace a Configurar e implementar análisis de ráster. 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ámetroExplicaciónTipo 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á.

  • VERTICALLos cálculos de distancia de flujo representan el componente vertical mínimo en un flujo, siguiendo la ruta del flujo, desde cada celda del dominio hasta las celdas del curso de agua hacia el que fluyen. Esta es la opción predeterminada.
  • HORIZONTALLos cálculos de distancia de flujo representan el componente horizontal mínimo en un flujo, siguiendo la ruta del flujo, desde cada celda del dominio hasta las celdas en el curso de agua hacia el que fluyen.
String
flowDirectionType
(Opcional)

Especifica el tipo del ráster de dirección del flujo de entrada.

  • D8El ráster de dirección del flujo de entrada es de tipo D8. Esta es la opción predeterminada.
  • MFDEl ráster de dirección del flujo de entrada es de tipo Dirección del flujo múltiple (MFD).
  • DINFEl ráster de dirección del flujo de entrada es de tipo D-Infinity (DINF).
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.

  • MINIMUMSi existen varias rutas del flujo, se calcula la distancia de flujo mínima. Esta es la opción predeterminada.
  • WEIGHTED_MEANSi existen varias rutas del flujo, se calcula la distancia de flujo media ponderada. La proporción del flujo desde una celda hasta las celdas vecinas aguas abajo se usa como media para calcular la media ponderada.
  • MAXIMUMSi existen varias rutas del flujo, se calcula la distancia de flujo máxima.
String

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de salida.

Capa ráster

Muestra de código

Ejemplo 1 de FlowDistance (ventana de Python)

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")
Ejemplo 2 de FlowDistance (script independiente)

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

Temas relacionados