Résumé
Mosaïque le contenu d'un catalogue d'images dans un nouveau jeu de données raster.
Utilisation
Cet outil vous permet de convertir votre catalogue d'images de géodatabase en un jeu de données raster ; l'entrée est un catalogue d'images et la sortie est un nouveau jeu de données raster. Cet outil ne peut pas mosaïquer les données dans un jeu de données raster existant.
L'utilisation d'un jeu de données raster mosaïqué présente plusieurs avantages : affichage généralement plus rapide à toutes les échelles, économie d'espace du fait de l'absence de données superposées, et affichage des données avec généralement moins de raccords.
Vous devez définir le type de pixel pour qu'il corresponde à vos jeux de données raster en entrée existants. Si vous ne définissez pas le type de pixel, la valeur par défaut de 8 bits est appliquée et la sortie obtenue risque d'être incorrecte.
Vous pouvez enregistrer votre sortie au format BIL, BIP, BMP, BSQ, DAT, Carroyage Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF, CRF ou en tant que jeu de données raster de géodatabase.
Lorsque vous stockez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les environnements.
Le format GIF prend uniquement en charge des jeux de données raster monocanaux.
Les zones superposées de la mosaïque peuvent être gérées de plusieurs façons. Vous pouvez par exemple définir l'outil de manière à ce qu'il conserve uniquement les données du premier jeu de données raster, ou vous pouvez combiner les valeurs de cellule superposées. Il existe également plusieurs possibilités pour déterminer la manière de gérer une palette de couleurs, si le jeu de données raster en utilise une. Par exemple, vous pouvez conserver la palette de couleurs du dernier jeu de données raster utilisé dans la mosaïque.
Pour le mosaïquage des données discrètes, les options Premier, Minimum ou Maximum Opérateur de mosaïque donneront les résultats les plus significatifs. Les options Opérateur de mosaïque BLEND et MEAN sont particulièrement adaptées aux données continues.
Dans la mesure du possible, utilisez le dernier opérateur de mosaïque pour mosaïquer les jeux de données raster de mosaïque sur un jeu de données raster existant dans une géodatabase fichier ou une géodatabase d'entreprise. C'est de loin la méthode de mosaïquage la plus efficace.
Lors du mosaïquage de jeux de données raster contenant des palettes de couleurs, il est important de noter les différences entre les palettes de couleurs pour chaque jeu de données raster que vous choisissez de mosaïquer. Dans cette situation, utilisez l'outil Mosaïque pour le raster avec des palettes de couleurs différentes. Vous devez toutefois sélectionner un opérateur Mode de palette du mosaïquage adéquat. Si vous choisissez un mode de palette de couleurs inadéquat, votre sortie peut ne pas ressembler à ce que vous attendez.
Pour les jeux de données raster en entrée à virgule flottante de résolutions différentes ou lorsque les cellules ne sont pas alignées, il est recommandé de rééchantillonner toutes les données à l'aide de l'interpolation bilinéaire ou de la convolution cubique avant d'exécuter Mosaïque. Dans le cas contraire, Mosaïque rééchantillonne automatiquement les jeux de données raster à l'aide de la méthode du voisin le plus proche, qui n'est pas adaptée aux types de données continus.
La correspondance et la correction des couleurs permettent de rendre la mosaïque de raster plus transparente.
Syntaxe
arcpy.management.RasterCatalogToRasterDataset(in_raster_catalog, out_raster_dataset, {where_clause}, {mosaic_type}, {colormap}, {order_by_field}, {ascending}, {pixel_type}, {ColorBalancing}, {MatchingMethod}, {ReferenceRaster}, {OID})| Paramètre | Explication | Type de données |
in_raster_catalog | Catalogue d'images qui sera mosaïqué dans un jeu de données raster. | Raster Catalog Layer |
out_raster_dataset | Nom et extension de la mosaïque du jeu de données raster en sortie. Pour enregistrer le jeu de données raster dans un format de fichier, vous devez spécifier une extension de fichier :
Pour enregistrer un jeu de données raster dans une géodatabase, vous ne devez ajouter aucune extension de fichier au nom du jeu de données raster. Lorsque vous enregistrez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000, un fichier TIFF ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les environnements de géotraitement. | Raster Dataset |
where_clause (Facultatif) | Entrez l'instruction SQL appropriée pour sélectionner des lignes spécifiques dans le catalogue d'images. | SQL Expression |
mosaic_type (Facultatif) | La méthode utilisée pour mosaïquer des zones superposées.
Pour plus d'informations sur chaque opérateur de mosaïque, reportez-vous à la rubrique Opérateur de mosaïque. | String |
colormap (Facultatif) | La méthode utilisée pour choisir la palette de couleurs des rasters en entrée sera appliquée à la mosaïque en sortie.
Pour plus d'informations sur chaque mode de palette de couleurs, reportez-vous à la rubrique Mode de palette du mosaïquage. | String |
order_by_field (Facultatif) | Définissez le champ utilisé pour trier les éléments du catalogue d'images. | String |
ascending (Facultatif) | Indiquez si la valeur croissante du champ order_by_field doit être utilisée. Si l'option Croissant n'est pas utilisée, l'ordre décroissant sera utilisé.
| Boolean |
pixel_type (Facultatif) | Détermine la profondeur de couleur du jeu de données raster en sortie. Si elle n'est pas renseignée, la profondeur de couleur en sortie est identique à celle en entrée. Aucune remise à l'échelle des valeurs de raster n'a lieu lorsqu'un type de pixel différent est choisi. Si le type de pixel est rétrogradé (remplacé par un type inférieur), les valeurs de raster situées en dehors de la plage autorisée pour cet espace par pixel sont tronquées et perdues.
| String |
ColorBalancing (Facultatif) | Choisissez d'utiliser ou non une technique d'éclaircissement pour corriger les couleurs des éléments du catalogue d'images. Tous les pixels du catalogue d'images serviront à déterminer les valeurs gamma et de contraste de l'algorithme d'équilibrage des couleurs.
| Boolean |
MatchingMethod (Facultatif) | Sélectionnez la méthode de correspondance des couleurs à appliquer aux rasters.
| String |
ReferenceRaster (Facultatif) | Si la correspondance des couleurs est appliquée, choisissez le mode de spécification du raster de référence.
| String |
OID (Facultatif) | ID d'objet (OID) du raster de référence. L'OID est un champ de clé unique dans le catalogue d'images. | Long |
Exemple de code
Exemple 1 d'utilisation de l'outil RasterCatalogToRasterDataset (fenêtre Python)
Il s'agit d'un exemple Python d'utilisation de l'outil RasterCatalogToRasterDataset.
import arcpy
arcpy.RasterCatalogToRasterDataset_management("c:/data/fgdb.gdb/catalog1",
"c:/data/dataset.tif",
"OBJECTID>1", "LAST", "FIRST",
"", "", "8_BIT_UNSIGNED",
"COLOR_BALANCING",
"HISTOGRAM_MATCHING",
"CALCULATE_FROM_ALL", "")
Exemple 2 d'utilisation de l'outil RasterCatalogToRasterDataset (script autonome)
Il s'agit d'un exemple de script Python d'utilisation de l'outil RasterCatalogToRasterDataset.
##==================================
##Raster Catalog To Raster Dataset
##Usage: RasterCatalogToRasterDataset_management in_raster_catalog out_raster_dataset {where_clause} {LAST | FIRST | MINIMUM | MAXIMUM
## | MEAN | BLEND} {FIRST | REJECT | LAST | MATCH} {order_by_field} {NONE | ASCENDING}
## {8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
## {NONE | COLOR_BALANCING} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {CACULATE_FROM_ALL | SPECIFY_OID | DEFINE_FROM_SELECTION}
## {OID}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic a Unmanaged Raster Catalog to a TIFF format Raster Dataset with Color Correction
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog1","RC2RD\\dataset1.tif", "OBJECTID>1", "LAST", "FIRST", "", "",\
"8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "CALCULATE_FROM_ALL", "")
##Mosaic using the According Order of cretain Field
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog2","RC2RD\\dataset2.tif", "", "LAST", "FIRST", "POPULATION", \
"ASCENDING", "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "SPECIFY_OID", "2")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui