Résumé
Ajoute des jeux de données raster à une mosaïque à partir de nombreuses sources, notamment un fichier, un dossier, une table ou un service Web.
Utilisation
Les données raster ajoutées ne sont pas gérées ; par conséquent, la mosaïque est affectée si les données raster sont supprimées ou déplacées.
Vous pouvez ajouter uniquement des rasters à une mosaïque contenue dans une géodatabase. Celles qui sont créées à l'extérieur d'une géodatabase peuvent contenir uniquement le contenu d'un catalogue d'images ou d'une mosaïque créée au préalable.
Le paramètre Type raster identifie les métadonnées requises pour le chargement de données dans la mosaïque.
Syntaxe
AddRastersToMosaicDataset_management (in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs})| Paramètre | Explication | Type de données |
in_mosaic_dataset | Le chemin et le nom de la mosaïque à laquelle les données raster seront ajoutées. | Image Service; Mosaic Layer; String |
raster_type | Le type raster est propre aux produits d'imagerie. Il identifie les métadonnées, comme le géoréférencement, la date d'achat et le type de capteur, ainsi qu'un format de raster. Pour obtenir une liste de types raster, consultez la liste de rasters et de formats de données d'image pris en charge. Si vous utilisez un type raster LAS, Jeu de données LAS ou MNT, vous devez recourir à un fichier .art dans lequel la taille de cellule est spécifiée. | Raster Type |
input_path [input_path,...] | Chemin et nom du fichier, du dossier, du jeu de données raster, de la mosaïque, de la table ou du service. Tous les choix en entrée ne seront pas disponibles. Ceux disponibles dépendront du type raster sélectionné.
| File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (Facultatif) | Calcule les plages de tailles de cellule pour chaque raster dans la mosaïque. Ces valeurs sont écrites dans la table attributaire dans les colonnes minPS et maxPS.
| Boolean |
update_boundary (Facultatif) | Génère ou met à jour le polygone d'emprise d'une mosaïque. Par défaut, la limite fusionne tous les polygones d'emprise pour créer une limite unique qui représente l'étendue des pixels valides.
| Boolean |
update_overviews (Facultatif) | Définit et génère des aperçus pour une mosaïque.
| Boolean |
maximum_pyramid_levels (Facultatif) | Définit le nombre maximal de niveaux de pyramides qui seront utilisés dans la mosaïque. Par exemple, une valeur de 2 utilisera uniquement les deux premiers niveaux de pyramides du raster source. Si vous laissez ce paramètre vide ou si vous entrez la valeur -1, des pyramides seront créées avec tous les niveaux. Cette valeur peut affecter l'affichage et le nombre d'aperçus qui seront générés. | Long |
maximum_cell_size (Facultatif) | Définit la taille de cellule de pyramide maximale qui sera utilisée dans la mosaïque. | Double |
minimum_dimension (Facultatif) | Définit les dimensions minimales d'une pyramide raster qui sera utilisée dans la mosaïque. | Long |
spatial_reference (Facultatif) | Système de référence spatiale des données en entrée. Cela doit être spécifié si les données n'ont pas de système de coordonnées ; sinon, le système de coordonnées de la mosaïque est utilisé. Ce paramètre peut également être utilisé pour remplacer le système de coordonnées des données en entrée. | Spatial Reference |
filter (Facultatif) | Filtre pour les données en cours d'ajout à la mosaïque. Vous pouvez utiliser des expressions SQL pour créer le filtre de données. Les caractères génériques utilisés pour le filtre fonctionnent sur le chemin complet des données en entrée. L'instruction SQL suivante sélectionne les lignes dans lesquelles les ID d'objet suivants correspondent :
Si vous souhaitez ajouter uniquement une image TIFF, ajoutez un astérisque avant une extension de fichier.
Si vous voulez ajouter une image dont le chemin de fichier ou le nom de fichier contient le mot sensor, ajoutez un astérisque avant et après le mot sensor.
Vous pouvez également utiliser la syntaxe PERL pour créer un filtre de données.
La syntaxe PERL suivante avec plusieurs regroupements lexicaux dans le cadre de l'expression n'est pas prise en charge :
Vous pouvez utiliser la syntaxe suivante :
| String |
sub_folder (Facultatif) | Explore les sous-dossiers de manière récursive.
| Boolean |
duplicate_items_action (Facultatif) | Une vérification est effectuée pour voir si chaque raster a déjà été ajouté, à l'aide du chemin et du nom de fichier d'origine. Choisissez l'action à effectuer lorsqu'un chemin et un nom de fichier en double sont trouvés.
| String |
build_pyramids (Facultatif) | Crée des pyramides pour chaque raster source.
| Boolean |
calculate_statistics (Facultatif) | Calcule des statistiques pour chaque raster source.
| Boolean |
build_thumbnails (Facultatif) | Crée des miniatures pour chaque raster source.
| Boolean |
operation_description (Facultatif) | Description que vous voulez utiliser pour représenter cette opération d'ajout de données raster. Elle sera ajoutée à la table des types raster, qui peut être utilisée dans le cadre d'une recherche ou comme référence à un autre moment. | String |
force_spatial_reference (Facultatif) | Utilisez le système de coordonnées spécifié dans le paramètre spatial_reference pour tous les rasters lors du chargement de données dans la mosaïque.
| Boolean |
estimate_statistics (Facultatif) | Evalue les statistiques sur la mosaïque pour accélérer le rendement et le traitement au niveau de la mosaïque.
| Boolean |
aux_inputs [aux_inputs,...] (Facultatif) | Il s'agit des paramètres des types de rasters définis sur la page Propriétés du type raster. Les valeurs de ce paramètre annulent celles qui sont définies dans la page Propriétés du type raster. | Value Table |
Exemple de code
Exemple 1 d'utilisation de l'outil AddRastersToMosaicDataset (fenêtre Python)
Il s'agit d'un exemple Python d'utilisation de l'outil AddRastersToMosaicDataset.
import arcpy
arcpy.AddRastersToMosaicDataset_management(
"c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+",
"c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
"NO_OVERVIEWS", "UPDATE_OVERVIEWS", "2", "#", "#",
"GCS_WGS_1984.prj","*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE")
Exemple 2 d'utilisation de l'outil AddRastersToMosaicDataset (script autonome)
Il s'agit d'un exemple de script Python d'utilisation de l'outil AddRastersToMosaicDataset.
#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Non
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui