Distancia de flujo (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Computa, para cada celda, el componente horizontal o vertical en una distancia de pendiente descendente, siguiendo la ruta del flujo, hasta una o varias celdas de un curso de agua hacia el que fluyen. En caso de varias rutas del flujo, se puede calcular la distancia de flujo mínima, media ponderada y 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

  • 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 realizarían 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 proporcionar 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 del 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.

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

  • 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. 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 Con, 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 en el resultado.

  • 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. El tema de ayuda Procesamiento en paralelo con Spatial Analyst contiene 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 5.000 x 5.000 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.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

FlowDistance(in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type}, {statistics_type})
ParámetroExplicaciónTipo de datos
in_stream_raster

Un ráster de curso de agua de entrada que representa una red de curso de agua lineal.

Raster Layer
in_surface_raster

Ráster de entrada que representa una superficie continua.

Raster Layer
in_flow_direction_raster
(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 de flujo se puede crear con la herramienta Dirección de flujo.

El ráster de dirección del flujo se puede crear con los métodos D8, Dirección del flujo múltiple (MFD) y D-Infinity. Utilice el parámetro flow_direction_type para especificar el método que se utilizó cuando se creó el ráster de dirección del flujo.

Raster Layer
distance_type
(Opcional)

Determina si se calcula el componente vertical u horizontal de la distancia de flujo.

  • VERTICALLos cálculos de distancia de flujo representan el componente vertical 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 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
flow_direction_type
(Opcional)

El ráster de dirección del flujo de entrada puede ser de tipo D8, Dirección del flujo múltiple (MFD) o D-Infinity (DINF).

  • 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
statistics_type
(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 ponderaciones para calcular la media ponderada.
  • MAXIMUMSi existen varias rutas del flujo, se calcula la distancia de flujo máxima.
String

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de distancia de flujo de salida.

Raster

Muestra de código

Ejemplo 1 de FlowDistance (ventana de Python)

Este ejemplo crea un ráster de distancia de flujo.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowDistance = FlowDistance("streams", "elevation", "", "VERTICAL")
outFlowDistance.save("C:/sapyexamples/output/outflowdist01")
Ejemplo 2 de FlowDistance (script independiente)

Este ejemplo crea un ráster de distancia de flujo.

# Name: FlowDistance_Example.py
# Description: Creates a raster of horizontal flow distance from each cell to a cell 
# on the stream into which it drains.
# 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
inStreamRaster = "streams"
inSurfaceRaster = "elevation"
inFlowDirectionRaster = "flowdir"


# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FlowDistance
outFlowDistance = FlowDistance(inStreamRaster, inSurfaceRaster, inFlowDirectionRaster, "HORIZONTAL")

# Save the output 
outFlowDistance.save("C:/sapyexamples/output/outflowdist02")

Información de licenciamiento

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

Temas relacionados