Disponible con una licencia de Spatial Analyst.
Resumen
Crea un ráster de flujo acumulado para cada celda. Opcionalmente, puede aplicar un factor de peso.
Ilustración
Uso
El resultado de Acumulación de flujo es un ráster de flujo acumulado para cada celda, determinado por la acumulación del peso de todas las celdas que fluyen hacia cada celda de pendiente descendente.
Las celdas con dirección de flujo indefinida sólo recibirán un flujo; no contribuirán a ningún flujo aguas abajo. Se considera que una celda tiene una dirección de flujo indefinida si su valor en el ráster de dirección de flujo es diferente que 1, 2, 4, 8, 16, 32, 64 o 128.
El flujo acumulado está basado en la cantidad de celdas que fluyen hacia cada celda en el ráster de salida. En esta acumulación no se considera la celda de procesamiento actual.
Las celdas de salida con una acumulación de flujo alta son áreas de flujo concentrado y se pueden utilizar para identificar canales de arroyo.
Las celdas de salida con una acumulación de flujo de cero son alturas topográficas locales y se pueden utilizar para identificar crestas.
Si el ráster de dirección de flujo de entrada no se crea con la herramienta Dirección del flujo existe la posibilidad de que se repita el flujo definido. Si, de hecho, la dirección del flujo se repite, la Dirección del flujo entrará en un bucle infinito y nunca finalizará.
La herramienta Dirección del flujo no respeta la configuración del entorno Compresión. El ráster de salida siempre estará descomprimido.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
FlowAccumulation (in_flow_direction_raster, {in_weight_raster}, {data_type})
Parámetro | Explicación | Tipo de datos |
in_flow_direction_raster | Ráster de entrada que muestra la dirección del flujo de cada celda. El ráster de dirección de flujo se puede crear con la herramienta Dirección de flujo. | Raster Layer |
in_weight_raster (Opcional) | Ráster de entrada opcional para aplicar un peso en cada celda. Si no se especifica ningún ráster de peso, se aplicará un peso predeterminado de 1 a cada celda. Para cada celda del ráster de salida, el resultado será la cantidad de celdas que fluyan en el mismo. | Raster Layer |
data_type (Opcional) | El ráster de acumulación de salida puede ser de tipo entero o punto flotante.
| String |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_accumulation_raster | El ráster de salida que muestra el flujo acumulado para cada celda. | Raster |
Muestra de código
Ejemplo 1 de FlowAccumulation (ventana de Python)
En este ejemplo se crea un ráster de flujo acumulado en cada celda de un ráster de cuadrícula de dirección de flujo de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowAccumulation = FlowAccumulation("flowdir")
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc01")
Ejemplo 2 de FlowAccumulation (secuencia de comandos independiente)
En este ejemplo se crea un ráster de flujo acumulado en cada celda de un ráster IMG de dirección de flujo de entrada.
# Name: FlowAccumulation_Ex_02.py
# Description: Creates a raster of accumulated flow to each cell.
# 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
inFlowDirRaster = "flowdir"
inWeightRaster = ""
dataType = "INTEGER"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outFlowAccumulation = FlowAccumulation(inFlowDirRaster, inWeightRaster, dataType)
# Save the output
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc02.img")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst