Créer un masque binaire (Image Analyst)

Disponible avec une licence Image Analyst.

Synthèse

Convertit un jeu de données raster en entrée en un raster binaire. Les pixels sont étiquetés en tant que masque ou arrière-plan selon des valeurs définies par l’utilisateur.

Utilisation

  • Cet outil classe un raster en entrée en tant qu’arrière-plan ou masque en fonction des valeurs des paramètres et génère un raster de masque binaire où la valeur 1 indique des pixels de masque et la valeur 0 indique des pixels d’arrière-plan.

    Remarque :

    Créez l’arrière-plan initial du raster en entrée en utilisant d’abord une fonction de seuil telle que Classification, Définition d’un seuil binaire, Classification zonale, Masque, des opérateurs mathématiques (<, <, >, >) et d’autres.

  • Une fois le raster de masque binaire en sortie appliqué à un raster, les pixels superposés aux pixels d’arrière-plan du raster de masque binaire sont transformés en NoData.

  • À l’aide de cet outil, vous pouvez éliminer les petites régions, réduire ou développer des régions, remplir les petites régions d’arrière-plan et lisser les limites.

  • Le paramètre Remplissage par diffusion à partir des contours de l’image vous permet de spécifier si les pixels dans la limite du masque sont classés ou non comme arrière-plan.

  • Utilisez le paramètre Remplissage par diffusion à partir des contours de l’image pour créer un masque d’une île qui gère les pixels d’eau sur l’île en tant que valeurs de masque. L’outil effectue un remplissage par diffusion sur les pixels d’eau et se termine lorsqu’il atteint les pixels terrestres. Les limites du masque en sortie restent intactes.

    Remplissage par diffusion à partir des contours de l’image
    Le paramètre Remplissage par diffusion à partir des contours de l’image est sélectionné (première image) et non sélectionné (seconde image).

  • Les unités des valeurs des paramètres Développer le masque et Développer l’arrière-plan sont les pixels. Les valeurs peuvent être négatives, ce qui génère un rétrécissement du masque et de l’arrière-plan.

  • Pour supprimer les petits groupes de pixels d’arrière-plan, utilisez une valeur négative pour le paramètre Développer le masque et une valeur positive pour le paramètre Développer l’arrière-plan.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster en entrée. Si l’entrée comporte plusieurs bandes, la première est utilisée par défaut.

Mosaic Layer; Raster Layer; Image Service; String; Raster Dataset; Mosaic Dataset
Raster de masque en sortie

Jeu de données raster binaire en sortie. Les formats pris en charge sont TIFF, CRF et PNG.

Raster Dataset
Valeur d’arrière-plan
(Facultatif)

Valeur d’arrière-plan du raster en sortie. La valeur par défaut est 0.

Double
Remplissage par diffusion à partir des contours de l’image
(Facultatif)

Indique comment les valeurs de pixel d’arrière-plan sont déterminées.

  • Activé : les valeurs de pixel d’arrière-plan sont déterminées par l’opération de remplissage par diffusion, qui remplit les pixels connectés à partir de la limite de l’image jusqu’à la limite du masque. Les pixels à l’intérieur du masque ne sont pas convertis en arrière-plan, quelle que soit leur valeur.
  • Désactivé : les valeurs de pixel d’arrière-plan sont déterminées par la valeur d’arrière-plan spécifiée. Il s’agit de l’option par défaut.

Boolean
Développer l’arrière-plan
(Facultatif)

Nombre de pixels qui serviront à développer ou à réduire l’arrière-plan. Des valeurs négatives rétrécissent l’arrière-plan.

Long
Développer le masque
(Facultatif)

Nombre de pixels qui serviront à développer ou à réduire le masque. Des valeurs négatives rétrécissent le masque.

Long
Taille de zone de masque minimale
(Facultatif)

Nombre de pixels connectés qui serviront à définir une région de masque. Les régions de masque dont la taille est inférieure sont classées comme arrière-plan.

Long
Définir l’arrière-plan comme NoData
(Facultatif)

Indique si la valeur d’arrière-plan est définie sur NoData.

  • Activé : la valeur d’arrière-plan est définie sur NoData.
  • Désactivé : la valeur d’arrière-plan n’est pas définie sur NoData. Il s’agit de l’option par défaut.

Boolean

CreateBinaryMask(in_raster, out_raster, {background_value}, {flood_fill}, {expand_background}, {expand_mask}, {min_region_size}, {background_nodata})
NomExplicationType de données
in_raster

Jeu de données raster en entrée. Si l’entrée comporte plusieurs bandes, la première est utilisée par défaut.

Mosaic Layer; Raster Layer; Image Service; String; Raster Dataset; Mosaic Dataset
out_raster

Jeu de données raster binaire en sortie. Les formats pris en charge sont TIFF, CRF et PNG.

Raster Dataset
background_value
(Facultatif)

Valeur d’arrière-plan du raster en sortie. La valeur par défaut est 0.

Double
flood_fill
(Facultatif)

Indique comment les valeurs de pixel d’arrière-plan sont déterminées.

  • FLOOD_FILLLes valeurs de pixel d’arrière-plan sont déterminées par l’opération de remplissage par diffusion, qui remplit les pixels connectés à partir de la limite de l’image jusqu’à la limite du masque. Les pixels à l’intérieur du masque ne sont pas convertis en arrière-plan, quelle que soit leur valeur.
  • NO_FLOOD_FILLLes valeurs de pixel d’arrière-plan sont déterminées par la valeur d’arrière-plan spécifiée. Il s’agit de l’option par défaut.
Boolean
expand_background
(Facultatif)

Nombre de pixels qui serviront à développer ou à réduire l’arrière-plan. Des valeurs négatives rétrécissent l’arrière-plan.

Long
expand_mask
(Facultatif)

Nombre de pixels qui serviront à développer ou à réduire le masque. Des valeurs négatives rétrécissent le masque.

Long
min_region_size
(Facultatif)

Nombre de pixels connectés qui serviront à définir une région de masque. Les régions de masque dont la taille est inférieure sont classées comme arrière-plan.

Long
background_nodata
(Facultatif)

Indique si la valeur d’arrière-plan est définie sur NoData.

  • BACKGROUND_NODATALa valeur d’arrière-plan est définie sur NoData.
  • BACKGROUND_DATALa valeur d’arrière-plan n’est pas définie sur NoData. Il s’agit de l’option par défaut.
Boolean

Exemple de code

CreateBinaryMask (fenêtre Python)

Cet exemple crée un raster binaire dans lequel tous les pixels dans la limite du masque sont remplis.

#Import system modules and check out extension
import arcpy 
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst") 

#Execute
output = arcpy.ia.CreateBinaryMask(r'C:\data\in_raster.crf”, 0, True, 0, 0, 100, 'BACKGROUND_DATA'') 

#Save output
output.save('c:\data\out_mask.tif')
CreateBinaryMask (script autonome)

Cet exemple crée un raster binaire dans lequel tous les pixels dans la limite du masque sont remplis.

# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy 
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst") 

#Set local variables
in_raster = r'C:\data\input_raster.crf'         
background_value=0        
flood_fill=True     
expand_background=0        
expand_mask=0     
min_region_size=100       
background_nodata=False     
   
#Execute
out_raster = arcpy.ia.CreateBinaryMask(in_raster, background_value, flood_fill, 
				expand_background, expand_mask, min_region_size, 
				background_nodata)

#Save the output
out_raster.save(r'C:\Data\FloodMap\WaterMask.crf')

Rubriques connexes