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.

• Vous pouvez spécifier plusieurs valeurs NoData par le paramètre Canaux pour la valeur NoData. Insérez un espace entre chaque valeur que vous voulez définir en tant que NoData.

• 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}, {Composite_nodata_value})

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 [band {NoData value},...] (Facultatif)	Définissez des valeurs 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. Si vous souhaitez définir plusieurs valeurs NoData pour chaque sélection de canaux, insérez un espace entre chaque valeur NoData dans le paramètre bands_for_nodata_value. 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 [band {minimum value} {maximum value},...] (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
Composite_nodata_value (Facultatif)	Décidez si tous les canaux doivent être NoData pour que le pixel soit marqué comme NoData. NO_COMPOSITE_NODATA —Si l'un des canaux a des pixels NoData, le pixel est classé comme NoData. Il s'agit de l'option par défaut. COMPOSITE_NODATA —Tous les canaux doivent avoir des pixels de NoData pour que le pixel soit classé comme NoData.	Boolean

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/Nodata.gdb/md", "3",  "ALL_BANDS '0 9'", "#", 
     "OBJECTID=2",  "COMPOSITE_NODATA")

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

Ceci est un exemple de script Python pour DefineMosaicDatasetNoData.

#Specify multiple Nodata values for all bands in one Catalog item

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "Nodata.gdb/md"
noofbands = "3"
nodataval = "ALL_BANDS '0 9'"
nodatarange = "#"
query = "OBJECTID=2"
mode = "#"

arcpy.DefineMosaicDatasetNoData_management(mdname, noofbands, nodataval, 
                                           nodatarange, query, mode)

Environnements

Etendue