Grignotage (Analyse raster)

Synthèse

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

Illustration

Illustration de l’outil Grignotage

Utilisation

  • Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS EnterpriseArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

    La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la sortie de l'outil Make Image Server Layer (Créer une couche de serveur d’imagerie). Cet outil ne prend pas en charge les couches ou données raster locales.

  • L’outil Grignotage permet d’attribuer à certaines zones d’un raster la valeur de leur voisin le plus proche. Il peut servir à remplacer certaines cellules individuelles par les valeurs situées immédiatement à proximité. Avec des zones de masque plus vastes, de plus grandes portions de cellules peuvent être remplacées.

  • 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ées. 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. Elles demeurent de type NoData quelle que soit la configuration des deux paramètres NoData.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée qui sera grignoté.

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

Raster Layer; Image Service; String
Raster de masque en entrée

Raster utilisé comme masque.

Les cellules qui sont de type NoData définissent les cellules qui seront grignotées, ou remplacées, par la valeur du voisin le plus proche.

Raster Layer; Image Service; String
Nom en sortie

Nom du service raster de grignotage en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

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

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

  • Activée : spécifie que la valeur du voisin le plus proche sera utilisée, que cette valeur soit NoData ou une autre valeur de données dans le raster en entrée. 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.
  • Non activée : spécifie que seules les valeurs de données sont libres de 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éfinit si les cellules NoData du raster en entrée qui se trouvent dans le masque resteront de type NoData dans le raster en sortie.

  • Désactivé : indique que les cellules NoData qui se trouvent dans le raster en entrée et dans le masque resteront de type NoData dans la sortie. Il s’agit de l’option par défaut.
  • Activé : indique que les cellules NoData qui se trouvent dans le raster en entrée et dans le masque peuvent être grignotées en valeurs de cellules valides.
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; Image Service; String

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster Layer

arcpy.ra.Nibble(inputRaster, inputMaskRaster, outputName, {nibbleValues}, {nibbleNodata}, {inputZoneRaster})
NomExplicationType de données
inputRaster

Raster en entrée qui sera grignoté.

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

Raster Layer; Image Service; String
inputMaskRaster

Raster utilisé comme masque.

Les cellules qui sont de type NoData définissent les cellules qui seront grignotées, ou remplacées, par la valeur du voisin le plus proche.

Raster Layer; Image Service; String
outputName

Nom du service raster de grignotage en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

String
nibbleValues
(Facultatif)

Mots-clés définissant si les valeurs NoData du raster en entrée peuvent grignoter la zone définie par le raster de masque.

  • ALL_VALUESSpécifie que la valeur du voisin le plus proche sera utilisée, que cette valeur soit NoData ou une autre valeur de données dans le raster en entrée. 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_ONLYSpécifie que seules les valeurs de données sont libres de 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
nibbleNodata
(Facultatif)

Mots-clés définissant si les cellules NoData du raster en entrée qui se trouvent dans le masque resteront de type NoData dans le raster en sortie.

  • PRESERVE_NODATAIndique que les cellules NoData qui se trouvent dans le raster en entrée et dans le masque resteront de type NoData dans la sortie. Il s’agit de l’option par défaut.
  • PROCESS_NODATAIndique que les cellules NoData qui se trouvent dans le raster en entrée et dans le masque peuvent être grignotées en valeurs de cellules valides.
Boolean
inputZoneRaster
(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; Image Service; String

Sortie obtenue

NomExplicationType de données
outputRaster

Raster en sortie.

Raster Layer

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

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes