Distancia de flujo—Ayuda

Disponible con una licencia de Spatial Analyst.

Resumen
Ilustración
Uso
Sintaxis
Muestra de código
Entornos
Información sobre licencias

Resumen

Computa, para cada celda, el componente horizontal o vertical mínimo en una pendiente descendente, siguiendo la ruta del flujo, hasta una o varias celdas de un curso de agua hacia el que fluyen.

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

Para limitar las direcciones descendentes a lo largo de las cuales se mide la distancia del flujo mínima, 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 mínima 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. 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\Desktop10.6\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 válidos para esta herramienta.

Sintaxis

FlowDistance (in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type})

Parámetro	Explicación	Tipo 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. VERTICAL —Los 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. HORIZONTAL —Los 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
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). D8 —El ráster de dirección del flujo de entrada es de tipo D8. Esta es la opción predeterminada. MFD —El ráster de dirección del flujo de entrada es de tipo Dirección del flujo múltiple (MFD).La opción MFD está disponible en la lista desplegable solamente si la herramienta cuenta con un ráster de dirección del flujo de entrada de tipo MFD. DINF —El ráster de dirección del flujo de entrada es de tipo D-Infinity (DINF).	String

Valor de retorno

Nombre	Explicación	Tipo 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")

ArcMap

Distancia de flujo