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

Synthèse

Spécifie une ou plusieurs valeurs à représenter comme NoData.

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.

Paramètres

ÉtiquetteExplicationType de données
Mosaïque

Mosaïque dans laquelle vous voulez mettre à jour les valeurs NoData.

Mosaic Layer
Nombre de canaux

Nombre de canaux dans la mosaïque.

Long
Canaux pour la valeur NoData
(Facultatif)

Spécifiez la valeur NoData de chaque canal. Une valeur NoData unique peut être définie pour chaque canal. Vous pouvez également utiliser la même valeur pour tous les canaux. Choisissez le canal dans la liste déroulante et entrez une ou plusieurs valeurs. Si vous sélectionnez plusieurs valeurs NoData, séparez chaque valeur par un espace.

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
Canaux pour la plage de données valide
(Facultatif)

Indiquez une plage de valeurs à afficher pour chaque canal. Les valeurs qui se trouvent en dehors de cette plage sont classées comme NoData. Lorsque vous utilisez des canaux composites, la plage s'applique à tous les canaux.

Value Table
Ensemble de définition
(Facultatif)

Instruction SQL permettant de sélectionner un raster spécifique au sein de la mosaïque. Seules les valeurs NoData des rasters sélectionnés seront modifiées.

SQL Expression
La valeur composite NoData à partir de chaque canal
(Facultatif)

Décidez si tous les canaux doivent être NoData pour que le pixel soit classé comme NoData.

  • Désactivé : si des canaux comportent des pixels NoData, le pixel est classé comme NoData. Il s’agit de l’option par défaut.
  • Activé : tous les canaux doivent avoir des pixels NoData pour que le pixel soit classé comme NoData.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Mosaïque mise à jour

Jeu de données mosaïque mis à jour.

Couche de mosaïque

arcpy.management.DefineMosaicDatasetNoData(in_mosaic_dataset, num_bands, {bands_for_nodata_value}, {bands_for_valid_data_range}, {where_clause}, {Composite_nodata_value})
NomExplicationType de données
in_mosaic_dataset

Mosaïque dans laquelle vous voulez mettre à jour les valeurs NoData.

Mosaic Layer
num_bands

Nombre de canaux dans la mosaïque.

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)

Indiquez une plage de valeurs à afficher pour chaque canal. Les valeurs qui se trouvent en dehors de cette plage sont classées comme NoData. Lorsque vous utilisez des canaux composites, la plage s'applique à tous les canaux.

Value Table
where_clause
(Facultatif)

Instruction SQL permettant de sélectionner un raster spécifique au sein de la mosaïque. Seules les valeurs NoData des rasters sélectionnés seront modifiées.

SQL Expression
Composite_nodata_value
(Facultatif)

Décidez si tous les canaux doivent être NoData pour que le pixel soit classé comme NoData.

  • NO_COMPOSITE_NODATASi l'un des canaux a des pixels NoData, le pixel est classé comme NoData. Il s’agit de l’option par défaut.
  • COMPOSITE_NODATATous les canaux doivent avoir des pixels de NoData pour que le pixel soit classé comme NoData.
Boolean

Sortie obtenue

NomExplicationType de données
out_mosaic_dataset

Jeu de données mosaïque mis à jour.

Couche de mosaïque

Exemple de code

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

Il s'agit d'un exemple de script 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