Ajouter des rasters à la mosaïque (Gestion des données)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Ajoute des jeux de données raster à une mosaïque à partir de nombreuses sources, notamment un fichier, un dossier, un catalogue d'images, une table ou un service Web.

Utilisation

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})
ParamètreExplicationType 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 spécifique pour les produits d'imagerie. Il identifie les métadonnées, comme le géoréférencement, la date d'acquisition 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 LAS, un jeu de données LAS ou un raster MNT, vous devez utiliser un fichier *.ART, dans lequel une 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, du catalogue d'images, 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é.

  • DatasetPermet de sélectionner un jeu de données géographiques ArcGIS, tel qu'un raster, un catalogue d'images ou une mosaïque dans une géodatabase ou une table.
  • Espace de travailPermet de sélectionner un dossier qui contient plusieurs jeux de données raster. Le dossier peut contenir des sous-dossiers.Ce paramètre est affecté par les paramètres Inclure les sous-dossiers et Filtre de données avancées.
  • FichierPermet de sélectionner un ou plusieurs jeux de données raster stockés dans un dossier sur le disque, un fichier de définition de service d'imagerie (.ISDef) et un fichier de définition de processus raster (.RPDef). Le robot de liste de fichiers ignore en outre les fichiers qui ne correspondent pas au type raster ajouté. Ne l'utilisez pas avec des formats de fichiers qui sont des jeux de données raster (tels que des fichiers TIFF ou MrSID), utilisez plutôt Jeu de données.
  • ServicePermet de sélectionner un service WCS, de carte ou d'imagerie, ou un fichier de couches de service Web.
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.

  • UPDATE_CELL_SIZESLes plages de taille de cellule sont calculées pour tous les rasters dans la mosaïque. Il s'agit de l'option par défaut.
  • NO_CELL_SIZESLes plages de taille de cellule ne sont pas calculées.
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.

  • UPDATE_BOUNDARYLa limite est générée ou mise à jour. Il s'agit de l'option par défaut.
  • NO_BOUNDARYLa limite n'est pas générée ou mise à jour.
Boolean
update_overviews
(Facultatif)

Définit et génère des aperçus pour une mosaïque.

  • UPDATE_OVERVIEWSDes aperçus sont définis et générés.
  • NO_OVERVIEWSAucun aperçu n'est défini ni généré. Il s'agit de l'option par défaut.
Boolean
maximum_pyramid_levels
(Facultatif)

Définit le nombre maximal de niveaux de pyramide qui seront utilisés dans la mosaïque. Par exemple, une valeur de 2 utilisera uniquement les deux premiers niveaux de pyramide 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 spatial 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.

  • OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591)

Si vous souhaitez ajouter uniquement une image TIFF, ajoutez un astérisque avant une extension de fichier.

  • *.TIF

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.

  • *sensor2009*

Vous pouvez également utiliser la syntaxe PERL pour créer un filtre de données.

  • REGEX: .*1923.*|.*1922.*

  • REGEX: .*192[34567].*|.*194.*|.*195.*

La syntaxe PERL suivante avec plusieurs regroupements lexicaux dans le cadre de l'expression n'est pas prise en charge.

  • REGEX: .* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img

Vous pouvez utiliser la syntaxe suivante.

  • REGEX: .*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img

String
sub_folder
(Facultatif)

Explore les sous-dossiers de manière récursive.

  • SUBFOLDERSDes données sont recherchées dans tous les sous-dossiers. Il s'agit de l'option par défaut.
  • NO_SUBFOLDERSLes données sont recherchées uniquement dans le dossier de niveau supérieur.
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.

  • ALLOW_DUPLICATESTous les rasters sont ajoutés même s'ils existent déjà dans la mosaïque. Il s'agit de l'option par défaut.
  • EXCLUDE_DUPLICATESLe raster en double n'est pas ajouté.
  • OVERWRITE_DUPLICATESLe raster en double remplace le raster existant.
String
build_pyramids
(Facultatif)

Crée des pyramides pour chaque raster source.

  • NO_PYRAMIDSAucune pyramide n'est générée. Il s'agit de l'option par défaut.
  • BUILD_PYRAMIDSDes pyramides sont générées.
Boolean
calculate_statistics
(Facultatif)

Calcule des statistiques pour chaque raster source.

  • NO_STATISTICSLes statistiques ne sont pas générées. Il s'agit de l'option par défaut.
  • CALCULATE_STATISTICSLes statistiques sont générées.
Boolean
build_thumbnails
(Facultatif)

Crée des miniatures pour chaque raster source.

  • NO_THUMBNAILSLes miniatures ne sont pas générées. Il s'agit de l'option par défaut.
  • BUILD_THUMBNAILSDes miniatures sont générées.
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é pour tous les rasters lors du chargement de données dans la mosaïque.

  • NO_FORCE_SPATIAL_REFERENCEConserve le système de coordonnées de chaque données raster lors du chargement de données. Il s'agit de l'option par défaut.
  • FORCE_SPATIAL_REFERENCEImposez le système de coordonnées spécifié dans cet outil pour chaque raster lors du chargement de données.
Boolean

Exemple de code

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

Ceci est 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)

Ceci est un exemple de script Python pour 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

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014