Nibble (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Reemplaza las celdas de un ráster que corresponden a una máscara con el valor del vecino más cercano.

Más información sobre cómo funciona Nibble

Ilustración

Ilustración de la herramienta Nibble
OutRas = Nibble(InRas1, Mask_Ras)

Uso

  • Puede utilizar la herramienta Nibble para seleccionar áreas de un ráster y asignarlas al valor de su vecino más cercano. La herramienta se puede utilizar para reemplazar celdas individuales por los valores inmediatamente más cercanos. Con áreas de máscara más grandes, se pueden reemplazar mayores franjas de celdas.

    Una aplicación habitual es la edición de áreas de un ráster en las que se sabe que los datos son erróneos.

  • Las celdas que son NoData en el ráster de máscara de entrada definen qué celdas se reemplazarán. Cualquier ubicación del ráster de entrada que no esté dentro del área de máscara no se reemplazará y el valor de salida será el mismo que el valor de entrada.

    Las celdas NoData del ráster de entrada que no se encuentran dentro de la máscara no se reemplazan. Las celdas seguirán siendo NoData, independientemente de la configuración de los dos parámetros NoData.

  • 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, 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

Ráster de entrada con las ubicaciones enmascaradas que se reemplazarán por el valor de su vecino más cercano.

El ráster de entrada puede ser de tipo entero o de punto flotante.

Raster Layer
Máscara del ráster de entrada

Ráster que identifica las ubicaciones del ráster de entrada se reemplazarán.

Las celdas con un valor de NoData se consideran ubicadas dentro del área enmascarada. En el ráster de salida, estas ubicaciones se reemplazarán por el valor de su vecino más cercano en el valor de Ráster de entrada.

El ráster de máscara puede ser de tipo entero o de punto flotante.

Raster Layer
Utilizar los valores NoData si son los del vecino más próximo (nearest neighbor)
(Opcional)

Especifica si las celdas NoData del ráster de entrada pueden sustituir a las celdas de las áreas enmascaradas si son el vecino más cercano.

  • Activado: las celdas del área enmascarada pueden ser reemplazadas tanto por valores NoData como por valores de datos. Esto significa que los valores NoData en el ráster de entrada pueden reemplazar áreas definidas en la máscara si son el vecino más cercano. Esta es la opción predeterminada.
  • Desactivado: las celdas del área enmascarada solo pueden ser reemplazadas por valores de datos. Los valores NoData en el ráster de entrada pueden reemplazar áreas definidas en el ráster de máscara si son el vecino más cercano.
Boolean
Celdas NoData de Nibble
(Opcional)

Especifica si las celdas NoData del ráster de entrada que están dentro del área enmascarada se conservarán o se reemplazarán.

  • Desactivado: las celdas NoData del ráster de entrada que están dentro del área enmascarada se conservarán (seguirán siendo NoData) en la salida. Esta es la opción predeterminada.
  • Activado: las celdas NoData del ráster de entrada que están dentro del área enmascarada pueden reemplazarse por el valor del vecino más cercano que esté fuera del área enmascarada.
Boolean
Ráster de entrada de zona
(Opcional)

El ráster de zona de entrada. En cada zona, las celdas de entrada que estén dentro de la máscara serán reemplazadas solamente por los valores de celda más cercanos dentro de esa misma zona.

Una zona consiste en las celdas de un ráster que tienen el mismo valor, tanto si son contiguas como si no. La capa de zona de entrada define la forma, los valores y las ubicaciones de las zonas. El ráster de zona puede ser de tipo entero o de punto flotante.

Raster Layer

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de salida con celdas reemplazadas.

Las celdas de entrada identificadas se reemplazarán por los valores del vecino más cercano.

Si el valor de in_raster es un entero, el ráster de salida será un entero. Si es un punto flotante, la salida será un punto flotante.

Raster

Nibble(in_raster, in_mask_raster, {nibble_values}, {nibble_nodata}, {in_zone_raster})
NombreExplicaciónTipo de datos
in_raster

Ráster de entrada con las ubicaciones enmascaradas que se reemplazarán por el valor de su vecino más cercano.

El ráster de entrada puede ser de tipo entero o de punto flotante.

Raster Layer
in_mask_raster

Ráster que identifica las ubicaciones del ráster de entrada se reemplazarán.

Las celdas con un valor de NoData se consideran ubicadas dentro del área enmascarada. En el ráster de salida, estas ubicaciones se reemplazarán por el valor de su vecino más cercano en el valor de in_raster.

El ráster de máscara puede ser de tipo entero o de punto flotante.

Raster Layer
nibble_values
(Opcional)

Especifica si las celdas NoData del ráster de entrada pueden sustituir a las celdas de las áreas enmascaradas si son el vecino más cercano.

  • ALL_VALUESLas celdas del área enmascarada pueden ser reemplazadas por valores NoData y valores de datos. Esto significa que los valores NoData en el ráster de entrada pueden reemplazar áreas definidas en la máscara si son el vecino más cercano. Esta es la opción predeterminada.
  • DATA_ONLYLas celdas del área enmascarada solo pueden ser reemplazadas por valores de datos. Los valores NoData en el ráster de entrada pueden reemplazar áreas definidas en el ráster de máscara si son el vecino más cercano.
Boolean
nibble_nodata
(Opcional)

Especifica si las celdas NoData del ráster de entrada que están dentro del área enmascarada se conservarán o se reemplazarán.

  • PRESERVE_NODATALas celdas NoData del ráster de entrada que están dentro del área enmascarada se conservarán (seguirán siendo NoData) en la salida. Esta es la opción predeterminada.
  • PROCESS_NODATALas celdas NoData del ráster de entrada que están dentro del área enmascarada pueden reemplazarse por el valor del vecino más cercano que esté fuera del área enmascarada.
Boolean
in_zone_raster
(Opcional)

El ráster de zona de entrada. En cada zona, las celdas de entrada que estén dentro de la máscara serán reemplazadas solamente por los valores de celda más cercanos dentro de esa misma zona.

Una zona consiste en las celdas de un ráster que tienen el mismo valor, tanto si son contiguas como si no. La capa de zona de entrada define la forma, los valores y las ubicaciones de las zonas. El ráster de zona puede ser de tipo entero o de punto flotante.

Raster Layer

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

Ráster de salida con celdas reemplazadas.

Las celdas de entrada identificadas se reemplazarán por los valores del vecino más cercano.

Si el valor de in_raster es un entero, el ráster de salida será un entero. Si es un punto flotante, la salida será un punto flotante.

Raster

Muestra de código

Ejemplo 1 de Nibble (ventana de Python)

En este ejemplo se sustituyen las celdas identificadas por la entrada de máscara con valores determinados por los vecinos más próximos del ráster de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nibbleOut = Nibble("land", "snow", "DATA_ONLY")
nibbleOut.save("C:/sapyexamples/output/nibbleout")
Ejemplo 2 de Nibble (script independiente)

En este ejemplo se sustituyen las celdas identificadas por la entrada de máscara con valores determinados por los vecinos más próximos del ráster de entrada.

# Name: Nibble_Ex_02.py
# Description: Replaces cells of a raster corresponding to a mask 
#              with the values of the nearest neighbors.
# 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
inRaster = "land"
inMask = "snow"

# Execute Nibble
nibbleOut = Nibble(inRaster, inMask, "ALL_VALUES")

# Save the output 
nibbleOut.save("C:/sapyexamples/output/outnibble")

Temas relacionados