Résumé
Crée un catalogue d’images vide dans une géodatabase
Utilisation
Une fois le catalogue d'images créé, les jeux de données raster peuvent être chargés à l'intérieur.
Les catalogues d'images peuvent être créés dans tout type de géodatabase.
Une fois le catalogue d'images créé, vous pouvez charger les jeux de données raster à l'intérieur en cliquant avec le bouton droit sur le catalogue d'images, puis en sélectionnant Charger les données. Les jeux de données raster peuvent également être chargés dans un catalogue d'images à l'aide de l'outil Espace de travail vers catalogue d’images.
Les catalogues d'images peuvent être gérés ou non par la géodatabase. Lorsque le catalogue d'images est géré par la géodatabase, les jeux de données raster du catalogue d'images sont physiquement stockés dans la géodatabase. Lorsqu'un enregistrement ou un raster est supprimé du catalogue, il est également supprimé de la géodatabase. Lorsque le catalogue d'images n'est pas géré, il contient uniquement des liens ou des pointeurs qui connectent un enregistrement à un jeu de données raster stocké à l'extérieur de la géodatabase. Ces jeux de données raster sont stockés à l'extérieur de la géodatabase. Tous les jeux de données raster chargés dans un catalogue d'images non géré doivent être un fichier sur le disque. Les jeux de données raster de géodatabase peuvent être chargés uniquement dans des catalogues d'images qui sont gérés. Les catalogues d'images stockés dans une géodatabase d'entreprise sont toujours gérés.
Nous vous recommandons d'utiliser l'outil Espace de travail vers catalogue d’images pour charger les données dans le catalogue d'images afin que la taille de l'index spatial soit calculée automatiquement.
Pour en savoir plus sur les éléments de géodatabase : index spatiaux et taille de la grille
Lorsque vous créez un catalogue d'images dans une géodatabase d'entreprise, le nom du jeu de données raster ne peut pas comporter d'espaces. Utilisez des traits de soulignement pour séparer les mots dans les noms des jeux de données raster.
Syntaxe
arcpy.management.CreateRasterCatalog(out_path, out_name, {raster_spatial_reference}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {raster_management_type}, {template_raster_catalog})
Paramètre | Explication | Type de données |
out_path | Géodatabase devant contenir le catalogue d'images. Il peut s'agir de n'importe quel type de géodatabase. | Workspace |
out_name | Nom du catalogue d'images à créer. | String |
raster_spatial_reference (Facultatif) | Système de coordonnées de la colonne raster dans le catalogue d'images. La référence spatiale de la colonne raster est utilisée au cours du chargement des données comme suit :
La valeur par défaut correspond au système de coordonnées défini dans les Environnements de géotraitement. | Coordinate System |
spatial_reference (Facultatif) | Le système de coordonnées de la colonne de géométrie. La référence spatiale de la colonne de géométrie définit la référence spatiale des emprises des jeux de données raster. La valeur par défaut correspond au système de coordonnées défini dans les Environnements de géotraitement. | Spatial Reference |
config_keyword (Facultatif) | Spécifie les paramètres de stockage (configuration) d’une géodatabase. Les mots-clés de configuration sont définis par l'administrateur de la base de données. | String |
spatial_grid_1 (Facultatif) | Les paramètres spatial_grid_1, spatial_grid_2 et spatial_grid_3 permettent de calculer un index spatial et s'appliquent seulement aux géodatabases fichier et aux géodatabases d'entreprise. Si vous êtes peu familier avec la définition de tailles de grille, laissez les valeurs 0,0,0 pour ces options et ArcGIS calculera des tailles optimales pour vous. Si vous utilisez la valeur de l'index spatial par défaut (de zéro), il est recommandé de charger les données à l'aide de l'outil Espace de travail vers catalogue d'images. Si cet outil est utilisé pour charger les jeux de données raster, la taille de l'index spatial est calculée automatiquement. Dans le cas contraire, c'est l'outil Calculer la valeur (de grille) d’index spatial par défaut qui doit être utilisé à l'issue du chargement. Pour plus d'informations sur ce paramètre, reportez-vous à la documentation relative à l'outil Ajouter un index spatial. | Double |
spatial_grid_2 (Facultatif) | Taille de cellule du deuxième index spatial. Laissez la taille à 0 si vous souhaitez seulement une grille. Sinon, définissez la taille sur une valeur au moins trois fois supérieure à Spatial Grid 1 (Grille spatiale 1). | Double |
spatial_grid_3 (Facultatif) | Taille de cellule du troisième index spatial. Laissez la taille à 0 si vous souhaitez seulement deux grilles. Sinon, définissez la taille sur une valeur au moins trois fois supérieure à Spatial Grid 2 (Grille spatiale 1). | Double |
raster_management_type (Facultatif) | Dans des catalogues d'images, les jeux de données raster peuvent être contrôlés de deux manières : gérés ou non gérés (par la géodatabase).
| String |
template_raster_catalog [template_raster_catalog,...] (Facultatif) | Si vous souhaitez baser votre nouveau catalogue d'images sur un modèle, vous pouvez spécifier un catalogue d'images modèle. Le nouveau catalogue d'images contiendra les mêmes champs que le catalogue d'images modèle. | Raster Catalog Layer |
Exemple de code
Exemple 1 d'utilisation de l'outil Créer un catalogue d'images (fenêtre Python)
Il s'agit d'un exemple Python d'utilisation de l'outil CreateRasterCatalog.
import arcpy
arcpy.CreateRasterCatalog_management("c:/data/CreateRC.gdb", "fgdb_unman",
"Albers_Conical.prj", "Albers_Conical.prj",
"MAX_FILE_SIZE_4GB", "1000", "3000", "9000",
"UNMANAGED", "")
Exemple 2 d'utilisation de l'outil CreateRasterCatalog (script autonome)
Il s'agit d'un exemple de script Python d'utilisation de l'outil CreateRasterCatalog.
##========================
##Create Raster Catalog
##Usage: CreateRasterCatalog_management out_path out_name {raster_spatial_reference} {spatial_reference} {config_keyword}
## {spatial_grid_1} {spatial_grid_2} {spatial_grid_3} {MANAGED | UNMANAGED}
## {template_raster_catalog;template_raster_catalog...}
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Create PGDB Unmanaged Raster Catalog
arcpy.CreateRasterCatalog_management("CreateRC.mdb", "Unmanaged", "Albers_Conical.prj", "Albers_Conical.prj", "", "12000", "", "", \
"UNMANAGED", "")
##Create FGDB Unmanaged Raster Catalog
arcpy.CreateRasterCatalog_management("CreateRC.gdb", "Unmanaged", "Albers_Conical.prj", "Albers_Conical.prj", "MAX_FILE_SIZE_4GB", \
"1000", "3000", "9000", "UNMANAGED", "")
##Create Managed Enterprise Raster Catalog with FGDB template
arcpy.CreateRasterCatalog_management("SDE94.sde", "Managed", "Albers_Conical.prj", "Albers_Conical.prj", "DEFAULTS","2000", "6000", \
"18000", "MANAGED", "CreateRC.mdb\\Unmanaged;CreateRC.gdb\\Unmanaged")
except:
print "Create Raster Catalog example failed."
print arcpy.GetMessages()
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui