Disponible con una licencia de Spatial Analyst.
Resumen
Crea un ráster que identifica todos los sumideros o áreas de drenaje interno.
Uso
Un sumidero es una celda o un conjunto de celdas conectadas espacialmente a cuya dirección de flujo no se le puede asignar uno de los ocho valores válidos en un ráster de dirección de flujo. Esto puede ocurrir cuando todas las celdas vecinas son mayores que la celda de procesamiento o cuando dos celdas fluyen entre sí, creando un bucle de dos celdas.
La herramienta Sumidero solo admite un ráster de dirección del flujo de entrada D8. Puede crear direcciones de flujo D8 con la herramienta Dirección de flujo; ejecútela con el tipo de dirección de flujo predeterminado, D8.
La salida de la herramienta Sumidero es un ráster entero en el que cada ráster tiene asignado un valor único. Los sumideros están enumerados entre uno y la cantidad de sumideros.
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
Sink(in_flow_direction_raster)
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, ejecutada con el tipo de dirección de flujo predeterminado, D8. | Raster Layer |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_raster | El ráster de salida que muestra todos los sumideros (áreas de drenaje interno) en la superficie de entrada. Esta salida es siempre de tipo entero. | Raster |
Muestra de código
Este ejemplo identifica los sumideros en 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"
outSink = Sink("flowdir")
outSink.save("C:/sapyexamples/output/outsink01")
Este ejemplo identifica los sumideros en un ráster de cuadrícula de dirección de flujo de entrada.
# Name: Sink_Ex_02.py
# Description: Creates a raster identifying all sinks or areas of internal drainage.
# 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
inFlowDirectionRaster = "flowdir"
# Execute FlowDirection
outSink = Sink(inFlowDirectionRaster)
# Save the output
outSink.save("C:/sapyexamples/output/outsink02")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst