Nibble (Análisis ráster)

Resumen

Reemplaza las celdas de un ráster que corresponden a una máscara con los valores de los vecinos más cercanos.

Ilustración

Ilustración de la herramienta Nibble

Uso

  • Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

    La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. Esta herramienta no admite capas o datos ráster locales.

  • Nibble permite asignar a las áreas seleccionadas de un ráster el valor de su vecino más cercano. 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.

  • 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. Seguirán siendo NoData, independientemente de la configuración de los dos parámetros NoData.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El ráster de entrada que se reasignará.

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

Raster Layer; Image Service; String
Ráster de máscara de entrada

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

Las celdas que son NoData definen las celdas que se reasignarán o que se reemplazarán por el valor del vecino más cercano.

Raster Layer; Image Service; String
Nombre de salida

Nombre del servicio ráster de Nibble de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

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

Define si se puede aplicar Nibble a los valores NoData del ráster de entrada en el área definida por el ráster de máscara.

  • Activado: especifica que el valor del vecino más cercano se utilizará en el ráster de salida, ya sea que se trate de NoData u otro valor de datos. 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: especifica que 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)

Define 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: especifica que las celdas NoData del ráster de entrada y de la máscara seguirán siendo NoData en la salida. Esta es la opción predeterminada.
  • Activado: especifica que las celdas NoData del ráster de entrada y de la máscara se pueden reasignar a valores de celda de salida válidos.
Boolean
Ráster de zona de entrada
(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; Image Service; String

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Raster Layer

arcpy.ra.Nibble(inputRaster, inputMaskRaster, outputName, {nibbleValues}, {nibbleNodata}, {inputZoneRaster})
NombreExplicaciónTipo de datos
inputRaster

El ráster de entrada que se reasignará.

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

Raster Layer; Image Service; String
inputMaskRaster

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

Las celdas que son NoData definen las celdas que se reasignarán o que se reemplazarán por el valor del vecino más cercano.

Raster Layer; Image Service; String
outputName

Nombre del servicio ráster de Nibble de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
nibbleValues
(Opcional)

Palabras clave que definen si se puede aplicar Nibble a los valores NoData del ráster de entrada en el área definida por el ráster de máscara.

  • ALL_VALUESEspecifica que el valor del vecino más cercano se utilizará en el ráster de salida, ya sea que se trate de NoData u otro valor de datos. 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_ONLYEspecifica que 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
nibbleNodata
(Opcional)

Palabras clave que definen 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_NODATAEspecifica que las celdas NoData del ráster de entrada y de la máscara seguirán siendo NoData en la salida. Esta es la opción predeterminada.
  • PROCESS_NODATAEspecifica que las celdas NoData del ráster de entrada y de la máscara se pueden reasignar a valores de celda de salida válidos.
Boolean
inputZoneRaster
(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; Image Service; String

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de salida.

Raster Layer

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
arcpy.ra.Nibble(
    "https://MyPortal.esri.com/server/rest/services/Hosted/in_raster/ImageServer",
    "https://MyPortal.esri.com/server/rest/services/Hosted/in_mask/ImageServer",
    "outnibbled1")
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 within defines zones.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputLayer      = "https://MyPortal.esri.com/server/rest/services/Hosted/inras/ImageServer"
inputMaskLayer  = "https://MyPortal.esri.com/server/rest/services/Hosted/inmask/ImageServer"
outputName      = "outnibbled2"
nibbleValuesOpt = "DATA_ONLY"
nibbleNodataOpt = "PROCESS_NODATA"
inputZoneLayer  = "https://MyPortal.esri.com/server/rest/services/Hosted/inzones/ImageServer"

arcpy.ra.Nibble(inputLayer, inputMaskLayer, outputName, nibbleValuesOpt, 
                nibbleNodataOpt, inputZoneLayer)

Información de licenciamiento

  • Basic: Requiere ArcGIS Image Server
  • Standard: Requiere ArcGIS Image Server
  • Advanced: Requiere ArcGIS Image Server

Temas relacionados