Grignotage (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Remplace les cellules d’un raster correspondant à un masque par les valeurs des voisins les plus proches.

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 permet aux zones sélectionnées d’un raster de se voir attribuer la valeur du 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 grignotées. Les emplacements du raster en entrée qui ne se trouvent pas dans la zone de masque ne seront pas grignotés. Leur valeur en sortie sera par conséquent identique à leur valeur en entrée.

    Les cellules NoData dans le raster en entrée qui ne se trouvent pas dans le masque ne sont pas grignoté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 qui sera grignoté.

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

Raster Layer
Masque raster en entrée

Raster utilisé comme masque.

Les cellules qui sont de type NoData dans le raster de masque identifient les cellules dans Input raster (Raster en entrée) qui seront grignotées, ou remplacées, par la valeur du voisin le plus proche.

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

Raster Layer
Utiliser les valeurs NoData s’il s’agit du voisin le plus proche
(Facultatif)

Détermine si les cellules NoData du raster en entrée peuvent grignoter la zone définie par le raster de masque.

  • Activée : les valeurs NoData et les valeurs de données peuvent grignoter les zones définies dans le raster de masque. Les valeurs NoData dans le raster en entrée sont libres de grignoter 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ée : seules les valeurs de données peuvent grignoter les zones définies dans le raster de masque. Les valeurs NoData dans le raster en entrée ne sont pas autorisées à grignoter 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)

Détermine si les cellules NoData du raster en entrée qui se trouvent dans le masque restent de type NoData dans le raster en sortie.

  • Désactivée : les cellules NoData du raster en entrée qui se trouvent dans le masque restent de type NoData dans la sortie. Il s’agit de l’option par défaut.
  • Activée : les cellules NoData du raster en entrée qui se trouvent dans le masque peuvent être grignotées en valeurs de cellules en sortie valides.
Boolean
Raster de zones en entrée
(Facultatif)

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

Raster grignoté en sortie.

Les cellules en entrée identifiées seront remplacées par les valeurs de leurs voisins les plus proches.

Si le in_raster est un nombre entier, le raster en sortie est 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 qui sera grignoté.

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

Raster Layer
in_mask_raster

Raster utilisé comme masque.

Les cellules qui sont de type NoData dans le raster de masque identifient les cellules dans in_raster qui seront grignotées, ou remplacées, par la valeur du voisin le plus proche.

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

Raster Layer
nibble_values
(Facultatif)

Détermine si les cellules NoData du raster en entrée peuvent grignoter la zone définie par le raster de masque.

  • ALL_VALUESLes valeurs NoData et les valeurs de données peuvent grignoter les zones définies dans le raster de masque. Les valeurs NoData dans le raster en entrée sont libres de grignoter 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 grignoter les zones définies dans le raster de masque. Les valeurs NoData dans le raster en entrée ne sont pas autorisées à grignoter les zones définies dans le raster de masque, même si elles constituent le voisin le plus proche.
Boolean
nibble_nodata
(Facultatif)

Détermine si les cellules NoData du raster en entrée qui se trouvent dans le masque restent de type NoData dans le raster en sortie.

  • PRESERVE_NODATA Les cellules NoData du raster en entrée qui se trouvent dans le masque restent de type 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 le masque peuvent être grignotées en valeurs de cellules en sortie valides.
Boolean
in_zone_raster
(Facultatif)

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

Raster grignoté en sortie.

Les cellules en entrée identifiées seront remplacées par les valeurs de leurs voisins les plus proches.

Si le in_raster est un nombre entier, le raster en sortie est 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")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes