Définir la valeur NoData de la mosaïque (Gestion des données)

Récapitulatif

Vous permet de préciser une ou plusieurs valeurs NoData pour une mosaïque.

Utilisation

• NoData permet de définir des valeurs de pixels qui entourent une image ; toutefois, l'efficacité de la mosaïque peut être accrue si les emprises sont recalculées de sorte à supprimer ces surfaces de limite. Pour recalculer les emprises, vous pouvez les modifier manuellement ou utiliser l'outil Générer des emprises.

• Cet outil insère la fonction Masque dans la chaîne de fonctions pour chaque élément raster d'une mosaïque.

• Avec cet outil, la fonction Masque est insérée avant la fonction Canaux composites dans la chaîne de fonctions. Par conséquent, si la chaîne de fonctions pour chaque raster de la mosaïque contient la fonction Canaux composites ou si vos données raster ont été ajoutées avec un type raster qui ajoute la fonction Canaux composites à la chaîne de fonctions de chaque raster, toute valeur que vous indiquez va s'appliquer à tous les canaux.

Syntaxe

DefineMosaicDatasetNoData_management (in_mosaic_dataset, num_bands, {bands_for_nodata_value}, {bands_for_valid_data_range}, {where_clause})

Paramètre	Explication	Type de données
in_mosaic_dataset	Chemin et nom de la mosaïque.	Mosaic Layer
num_bands	Définit le nombre de canaux dans la mosaïque. Cette valeur va être renseignée automatiquement, en fonction de la mosaïque ajoutée, mais vous pouvez la remplacer.	Long
bands_for_nodata_value [canal {valeur},...] (Facultatif)	Définissez une valeur unique pour chaque canal ou pour tous les canaux. Il peut être définie une valeur NoData unique pour chaque canal ou bien la même valeur peut être spécifiée pour tous les canaux. Avec cet outil, la fonction Masque est insérée avant la fonction Canaux composites dans la chaîne de fonctions. Par conséquent, si la chaîne de fonctions pour chaque raster de la mosaïque contient la fonction Canaux composites ou si vos données raster ont été ajoutées avec un type raster qui ajoute la fonction Canaux composites à la chaîne de fonctions de chaque raster, toute valeur que vous indiquez va s'appliquer à tous les canaux.	Value Table
bands_for_valid_data_range [canal {valeur minimum} {valeur maximum},...] (Facultatif)	Nombre de canaux et valeur de pixel minimum et maximum de données valides. Les valeurs NoData sont celles situées en dehors de la plage. Par exemple, pour une image 8 bits, si vous indiquez canal1=10-200, les valeurs 0-9 et 201-255 sont définies en tant que NoData. Avec cet outil, la fonction Masque est insérée avant la fonction Canaux composites dans la chaîne de fonctions. Par conséquent, si la chaîne de fonctions pour chaque raster de la mosaïque contient la fonction Canaux composites ou si vos données raster ont été ajoutées avec un type raster qui ajoute la fonction Canaux composites à la chaîne de fonctions de chaque raster, toute valeur que vous indiquez va s'appliquer à tous les canaux.	Value Table
where_clause (Facultatif)	A l'aide du SQL, vous pouvez définir une requête ou utiliser le Générateur de requêtes pour créer une requête.	SQL Expression

Exemple de code

Exemple 1 d'utilisation de l'outil DefineMosaicDataserNoData (fenêtre Python)

Ceci est un exemple Python pour DefineMosaicDatasetNoData.

import arcpy
arcpy.DefineMosaicDatasetNoData_management("c:/workspace/fgdb.gdb/NoData", \ 
                                           "OBJECTID=2", "3", \
                                           "ALL_BANDS 0 9", #")

Exemple 2 d'utilisation de l'outil DefineMosaicDataserNoData (script autonome)

Ceci est un exemple de script Python pour DefineMosaicDatasetNoData.

##===========================
##Define Mosaic Dataset Nodata
##Usage: DefineMosaicDatasetNodata_management in_mosaic_dataset num_bands
##                               {Band {Value};Band {Value}...} {Band {Minimum
##                               Value} {Maximum Value};Band {Minimum Value}
##                               {Maximum Value}...} {where_clause}

try:
    import arcpy
    arcpy.env.workspace = "C:/Workspace"
    # Specify multiple Nodata values for all bands in one Catalog item
    arcpy.DefineMosaicDatasetNoData_management("Nodata.gdb/md", "3", "ALL_BANDS 0 9",\
                                               "#", "OBJECTID=2")
                                  
    # Specify Nodata values for each individual band                            
    arcpy.DefineMosaicDatasetNodata_management("Nodata.gdb/md", "3",\
                                               "BAND_1 0;BAND_2 10;BAND_3 255", "#",\
                                               "#")
    
    # Specify valid value range for each band
    arcpy.DefineMosaicDatasetNodata_management("Nodata.gdb/md", "3", "", \
                                               "BAND_1 0 255;BAND_2 10 100;BAND_3 1 200",\
                                               "#")
    
    
except:
    print "Define Mosaic Dataset Nodata example failed."
    print arcpy.GetMessages() 

Environnements

Etendue