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 los valores de los vecinos más cercanos.

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

Ilustración

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

Uso

  • La herramienta Nibble permite asignar a las áreas seleccionadas de un ráster el 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 reasignarán. Cualquier ubicación del ráster de entrada que no esté dentro del área de máscara no será reasignada y, por tanto, su valor de salida será el mismo que su valor de entrada.

    Las celdas NoData del ráster de entrada que no estén dentro de la máscara no se reasignarán. 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

El ráster de entrada que se reasignará.

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

Raster Layer
Máscara del ráster de entrada

El ráster se utiliza como la máscara.

Las celdas que son NoData en el ráster de máscara identifican las celdas del Ráster de entrada que se reasignarán o que se reemplazarán por el valor del vecino más cercano.

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 reasignarse o no al área definida por el ráster de máscara.

  • Activado: especifica que tanto los valores de NoData como de datos pueden reasignarse a áreas definidas en el ráster de máscara. Los valores NoData en el ráster de entrada pueden reasignarse a áreas definidas en la máscara si son el vecino más próximo. Esta es la opción predeterminada.
  • Desactivado: solo los valores de datos pueden reasignarse a áreas definidas en el ráster de máscara. Los valores NoData en el ráster de entrada no pueden reasignarse a áreas definidas en el ráster de máscara, aunque sean el vecino más próximo.
Boolean
Celdas NoData de Nibble
(Opcional)

Especifica si las celdas NoData del ráster de entrada que se encuentran dentro de la máscara seguirán siendo NoData en el ráster de salida.

  • Desactivado: las celdas NoData del ráster de entrada que se encuentran dentro de la máscara 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 de la máscara se pueden reasignar a valores de celda de salida válidos.
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 son todas las celdas en un ráster que tienen el mismo valor, sean o no contiguas. La capa de zonas 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

El ráster reasignado de salida.

Las celdas de entrada identificadas se reemplazarán con los valores de los vecinos más cercanos.

Si la in_raster es de tipo entero, el ráster de salida será de tipo 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

El ráster de entrada que se reasignará.

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

Raster Layer
in_mask_raster

El ráster se utiliza como la máscara.

Las celdas que son NoData en el ráster de máscara identifican las celdas del in_raster que se reasignarán o que se reemplazarán por el valor del vecino más cercano.

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 reasignarse o no al área definida por el ráster de máscara.

  • ALL_VALUESEspecifica que tanto los valores de NoData como de datos pueden reasignarse a áreas definidas en el ráster de máscara. Los valores NoData en el ráster de entrada pueden reasignarse a áreas definidas en la máscara si son el vecino más próximo. Esta es la opción predeterminada.
  • DATA_ONLYSolo los valores de datos pueden reasignarse a áreas definidas en el ráster de máscara. Los valores NoData en el ráster de entrada no pueden reasignarse a áreas definidas en el ráster de máscara, aunque sean el vecino más próximo.
Boolean
nibble_nodata
(Opcional)

Especifica si las celdas NoData del ráster de entrada que se encuentran dentro de la máscara seguirán siendo NoData en el ráster de salida.

  • PRESERVE_NODATA Las celdas NoData del ráster de entrada que se encuentran dentro de la máscara 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 de la máscara se pueden reasignar a valores de celda de salida válidos.
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 son todas las celdas en un ráster que tienen el mismo valor, sean o no contiguas. La capa de zonas 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

El ráster reasignado de salida.

Las celdas de entrada identificadas se reemplazarán con los valores de los vecinos más cercanos.

Si la in_raster es de tipo entero, el ráster de salida será de tipo 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 (secuencia de comandos 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")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados