Disponible con una licencia de Spatial Analyst.
Resumen
Rellena hendiduras en una superficie de ráster para quitar pequeñas imperfecciones en los datos.
Ilustración
Uso
Un sumidero es una celda con una dirección de drenaje indefinida y las celdas que lo rodean son más bajas. El punto de fluidez es la celda límite con la elevación más baja del área de contribución de un sumidero. Si el sumidero estuviera relleno con agua, éste sería el punto desde donde manaría el agua.
El límite z especifica la diferencia máxima permitida entre la profundidad de un sumidero y el punto de fluidez y determina qué sumideros se rellenarán y cuáles permanecerán intactos. El límite z no es la profundidad máxima a la que se rellenará un sumidero.
Tomemos como ejemplo un sumidero en el que el punto de fluidez está situado a una altura de 210 pies, y el punto más profundo en el sumidero es de 204 pies (una diferencia de 6 pies). Si el límite z está ajustado en 8, este sumidero en concreto se rellenará. En cambio, si el límite z está ajustado en 4, este sumidero no se llenará porque su profundidad supera esta diferencia y se consideraría un sumidero válido.
Todos los sumideros menores que el límite z y en una posición más baja que la del vecino adyacente más bajo, se rellenarán a la altura de los puntos de fluidez.
La ejecución de la herramienta Relleno puede consumir muchos recursos de la memoria, la CPU y el disco. Puede requerir hasta cuatro veces el espacio en disco del ráster de entrada.
La cantidad de sumideros que se encuentren en el límite z determinará la duración del tiempo de procesamiento. Mientras más sumideros existan, mayor será el tiempo de procesamiento.
La herramienta Sumidero se puede usar antes que la herramienta Relleno para encontrar el número de sumideros y, de este modo, ayudar a identificar su profundidad. El conocimiento de la profundidad de los sumideros puede ayudar a determinar un límite z adecuado.
También puede utilizar el Relleno para quitar picos. Un pico es una celda sin ninguna celda adyacente más elevada. Para quitar los picos, debe invertir el ráster de superficie de entrada. Esto se puede hacer con la herramienta Resta. Especifique el valor más alto del ráster de superficie como la primera entrada de la Resta y el ráster de superficie como la segunda entrada. Realice un Relleno. Para obtener una superficie que tenga valores de ráster de superficie originales con los picos eliminados, invierta los resultados. También puede aplicar el límite z a este proceso. Si no se especifica nada como límite z, se quitarán todos los picos. Si en cambio se especifica un límite, no se quitará el pico en donde la diferencia en el valor z entre un pico y su vecino adyacente más elevado sea mayor que el límite z.
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
Fill(in_surface_raster, {z_limit})| Parámetro | Explicación | Tipo de datos |
in_surface_raster | Ráster de entrada que representa una superficie continua. | Raster Layer |
z_limit (Opcional) | Diferencia máxima de elevación entre un sumidero y su punto de fluidez, que debe rellenarse. Si la diferencia en los valores de z entre un sumidero y su punto de fluidez es mayor que z_limit, ese sumidero no se rellenará. El valor del límite Z debe ser mayor que cero. Si no se especifica un valor para este parámetro, todos los sumideros se llenarán independientemente de la profundidad. | Double |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_surface_raster | El ráster de superficie de salida después de haber rellenado los sumideros. Si el ráster de superficie es un entero, el ráster de salida será un entero. Si la entrada es de punto flotante, el ráster de salida será de punto flotante. | Raster |
Muestra de código
Este ejemplo rellena los sumideros de un ráster GRID de superficie de elevación de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFill = Fill("elevation")
outFill.save("C:/sapyexamples/output/outfill01")Este ejemplo rellena los sumideros de un ráster GRID de superficie de elevación de entrada con un límite z aplicado.
# Name: Fill_Ex_02.py
# Description: Fills sinks in a surface raster.
# 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
inSurfaceRaster = "elevation"
zLimit = 3.28
# Execute FlowDirection
outFill = Fill(inSurfaceRaster, zLimit)
# Save the output
outFill.save("C:/sapyexamples/output/outfill02")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst