Grignotage (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Remplace les cellules d’un raster correspondant à un masque par la valeur du voisin le plus proche.

Pour en savoir plus sur le fonctionnement de l’outil Grignotage

Illustration

Illustration de l’outil Grignotage
OutRas = Nibble(InRas1, Mask_Ras)

Utilisation

  • L’outil Grignotage peut être utilisé pour sélectionner des zones d’un raster et leur attribuer la valeur de leur voisin le plus proche. Cet outil peut être utilisé pour remplacer certaines cellules par les valeurs à proximité immédiate. Avec des zones de masque plus vastes, de plus grandes portions de cellules peuvent être remplacées.

    La mise à jour des zones d’un raster où les données sont connues comme étant erronées est une application commune.

  • Les cellules de type NoData dans le raster de masque en entrée définissent les cellules qui doivent être remplacées. Les emplacements du raster en entrée qui ne se trouvent pas dans la zone de masque ne seront pas remplacées. Leur valeur en sortie sera identique à leur valeur en entrée.

    Les cellules NoData du raster en entrée qui ne se trouvent pas dans le masque ne sont pas remplacées. Les cellules demeurent de type NoData quels que soient les réglages des deux paramètres NoData.

  • Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. La rubrique d’aide relative au traitement parallèle avec Spatial Analyst contient davantage de détails sur cette fonctionnalité et sur son mode de configuration.

    Lorsque vous utilisez le traitement parallèle, des données temporaires sont écrites afin de gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque local C. Vous pouvez contrôler l’emplacement de ce répertoire en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du répertoire à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administrateur sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pourcent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisé peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l'environnement Facteur de traitement parallèle.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée avec les localisations masquées qui seront remplacées par la valeur du voisin le plus proche.

Le raster en entrée peut être de type entier ou à virgule flottante.

Raster Layer
Masque raster en entrée

Raster identifiant les localisations qui seront remplacées dans le raster en entrée.

Les cellules avec la valeur NoData sont considérées comme étant à l’intérieur de la zone masquée. Dans le raster en sortie, ces localisations seront remplacées par la valeur de leur voisin le plus proche dans la valeur du raster en entrée.

Le raster de masque peut être de type entier ou à virgule flottante.

Raster Layer
Use NoData values if they are the nearest neighbor (Utiliser les valeurs NoData s’il s’agit du voisin le plus proche)
(Facultatif)

Spécifie si les cellules NoData dans le raster en entrée peuvent remplacer les cellules dans les zones masquées si elles constituent le voisin le plus proche.

  • Activé : les valeurs NoData comme les valeurs de données peuvent remplacer les cellules dans la zone masquée. Cela signifie que les valeurs NoData dans le raster en entrée peuvent remplacer les zones définies dans le masque si elles constituent le voisin le plus proche. Il s’agit de l’option par défaut.
  • Désactivé : seules les valeurs de données peuvent remplacer les cellules dans la zone masquée. Les valeurs NoData dans le raster en entrée ne peuvent pas remplacer les zones définies dans le raster de masque même si elles constituent le voisin le plus proche.
Boolean
Grignoter les cellules NoData
(Facultatif)

Indique si les cellules NoData du raster en entrée comprises dans la zone masquée seront conservées ou remplacées.

  • Désactivé : les cellules NoData du raster en entrée qui se trouvent dans la zone masquée sont conservées (leur type reste NoData) dans la sortie. Il s’agit de l’option par défaut.
  • Activé : les cellules NoData du raster en entrée qui se trouvent dans la zone masquée sont remplacées par la valeur du voisin le plus proche qui se trouve à l’extérieur de la zone masquée.
Boolean
Raster de zones en entrée
(Facultatif)

Le raster de zones en entrée. Pour chaque zone, les cellules en entrée qui se trouvent dans le masque seront remplacées uniquement par les valeurs de cellules les plus proches au sein de cette même zone.

Une zone contient toutes les cellules d’un raster possédant la même valeur, qu’elles soient contiguës ou non. La couche de zone en entrée régit la forme, les valeurs et les emplacements des zones. Le raster de zones peut être de type entier ou à virgule flottante.

Raster Layer

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Le raster en sortie avec les cellules remplacées.

Les cellules en entrée identifiées seront remplacées par les valeurs de leur voisin le plus proche.

Si la valeur in_raster est un nombre entier, le raster en sortie sera un nombre entier. S’il s’agit d’une valeur à virgule flottante, la sortie sera également à virgule flottante.

Raster

Nibble(in_raster, in_mask_raster, {nibble_values}, {nibble_nodata}, {in_zone_raster})
NomExplicationType de données
in_raster

Raster en entrée avec les localisations masquées qui seront remplacées par la valeur du voisin le plus proche.

Le raster en entrée peut être de type entier ou à virgule flottante.

Raster Layer
in_mask_raster

Raster identifiant les localisations qui seront remplacées dans le raster en entrée.

Les cellules avec la valeur NoData sont considérées comme étant à l’intérieur de la zone masquée. Dans le raster en sortie, ces localisations seront remplacées par la valeur de leur voisin le plus proche dans la valeur in_raster.

Le raster de masque peut être de type entier ou à virgule flottante.

Raster Layer
nibble_values
(Facultatif)

Spécifie si les cellules NoData dans le raster en entrée peuvent remplacer les cellules dans les zones masquées si elles constituent le voisin le plus proche.

  • ALL_VALUESLes valeurs NoData comme les valeurs de données peuvent remplacer les cellules dans la zone masquée. Cela signifie que les valeurs NoData dans le raster en entrée peuvent remplacer les zones définies dans le masque si elles constituent le voisin le plus proche. Il s’agit de l’option par défaut.
  • DATA_ONLYSeules les valeurs de données peuvent remplacer les cellules dans la zone masquée. Les valeurs NoData dans le raster en entrée ne peuvent pas remplacer les zones définies dans le raster de masque même si elles constituent le voisin le plus proche.
Boolean
nibble_nodata
(Facultatif)

Indique si les cellules NoData du raster en entrée comprises dans la zone masquée seront conservées ou remplacées.

  • PRESERVE_NODATALes cellules NoData du raster en entrée qui se trouvent dans la zone masquée seront conservées (leur type reste NoData) dans la sortie. Il s’agit de l’option par défaut.
  • PROCESS_NODATALes cellules NoData du raster en entrée qui se trouvent dans la zone masquée seront remplacées par la valeur du voisin le plus proche qui se trouve à l’extérieur de la zone masquée.
Boolean
in_zone_raster
(Facultatif)

Le raster de zones en entrée. Pour chaque zone, les cellules en entrée qui se trouvent dans le masque seront remplacées uniquement par les valeurs de cellules les plus proches au sein de cette même zone.

Une zone contient toutes les cellules d’un raster possédant la même valeur, qu’elles soient contiguës ou non. La couche de zone en entrée régit la forme, les valeurs et les emplacements des zones. Le raster de zones peut être de type entier ou à virgule flottante.

Raster Layer

Valeur renvoyée

NomExplicationType de données
out_raster

Le raster en sortie avec les cellules remplacées.

Les cellules en entrée identifiées seront remplacées par les valeurs de leur voisin le plus proche.

Si la valeur in_raster est un nombre entier, le raster en sortie sera un nombre entier. S’il s’agit d’une valeur à virgule flottante, la sortie sera également à virgule flottante.

Raster

Exemple de code

Exemple 1 d’utilisation de l’outil Grignotage (fenêtre Python)

Cet exemple remplace les cellules identifiées par le masque en entrée par les valeurs déterminées par les voisins les plus proches du raster en entrée.

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")
Exemple 2 d’utilisation de l’outil Grignotage (script autonome)

Cet exemple remplace les cellules identifiées par le masque en entrée par les valeurs déterminées par les voisins les plus proches du raster en entrée.

# 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")

Rubriques connexes