Disponible con una licencia de Spatial Analyst.
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 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
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 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á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 utilizando los métodos D8, Dirección del flujo múltiple (MFD) o D-Infinity. Use el parámetro flow_direction_type para especificar el método utilizado al crear el ráster de dirección de flujo. | Raster Layer |
distance_type (Opcional) | Determina si se calcula el componente vertical u horizontal de la distancia de flujo.
| String |
flow_direction_type (Opcional) | Especifica el tipo del ráster de dirección del flujo de entrada.
| 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.
| 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
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")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")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst