Créer un cache d'élément de mosaïque (Gestion des données)
Récapitulatif
Permet d'insérer la fonction Raster en cache dans la chaîne de fonctions pour les éléments d'une mosaïque.
Utilisation
La fonction Raster en cache est insérée en haut de chaque chaîne de fonctions et c'est donc la dernière fonction qui est implémentée dans la chaîne.
-
Si vous n'utilisez pas l'option Générer le cache de cet outil pour générer le cache, vous pouvez utiliser l'outil Synchroniser une mosaïque à cette fin.
Le cache n'est pas déplacé avec la mosaïque lorsqu'il est partagé (publié) sur le serveur. Si vous construisez le cache pour une mosaïque qui doit être publiée en tant que service d'imagerie, vous pouvez exécuter cet outil sur la mosaïque après l'avoir partagée sur le serveur. Veillez également à ce que le chemin d'accès au cache soit accessible sur le serveur. Si vous créez le cache avant de publier la mosaïque, vous pouvez déplacer le cache sur le serveur et mettre à jour le chemin du cache stocké dans la mosaïque.
Syntaxe
| Paramètre | Explication | Type de données |
in_mosaic_dataset |
Chemin et nom de la mosaïque. | Mosaic Layer |
where_clause (Facultatif) |
A l'aide du SQL, vous pouvez définir une requête ou utiliser le Générateur de requêtes pour créer une requête. | SQL Expression |
define_cache (Facultatif) |
Définissez le cache de la mosaïque. Une fonction Raster en cache est insérée dans les éléments sélectionnés. Si un élément contient déjà une fonction Raster en cache, elle n'est pas ajoutée.
| Boolean |
generate_cache (Facultatif) |
Vous pouvez choisir de générer les fichiers de cache en fonction des propriétés définies dans la fonction Raster en cache, telles que l'emplacement et la compression du cache.
| Boolean |
item_cache_folder (Facultatif) |
Emplacement où les jeux de données mis en cache sont stockés. Par défaut, le cache est généré et stocké dans un dossier proche de l'emplacement où se trouve la mosaïque. Ce dossier a le même nom que la géodatabase, associé à une extension .cache. Toutefois, si la mosaïque est créée dans une géodatabase ArcSDE, le cache sera créé dans cette géodatabase. Une fois qu'un cache d'élément est créé, il est impossible de le régénérer à un autre emplacement en spécifiant un autre chemin permettant d'y accéder et en ré-exécutant cet outil. Ce dernier continue à générer le cache d'élément à l'emplacement d'origine. Toutefois, vous pouvez supprimer cette fonction et en insérer une nouvelle associée à un nouveau chemin d'accès ou utiliser l'outil Réparer la mosaïque pour modifier le chemin d'accès au cache, puis exécuter cet outil pour générer le cache d'élément à un autre emplacement. | Workspace |
compression_method (Facultatif) |
Type de compression utilisé, le cas échéant, lors de la génération du cache.
| String |
compression_quality (Facultatif) |
Qualité de compression à utiliser avec la méthode de compression avec perte. La valeur de qualité de compression est comprise entre 1 et 100 pour cent. | Long |
max_allowed_rows (Facultatif) |
Limite la taille du jeu de données de cache par le nombre de pixels dans les lignes. Le raster cache n'est pas généré si la dimension dépasse cette limite. | Long |
max_allowed_columns (Facultatif) |
Limite la taille du jeu de données de cache par le nombre de pixels dans les colonnes. Le raster cache n'est pas généré si la dimension dépasse cette limite. | Long |
request_size_type (Facultatif) |
Choisissez si vous souhaitez spécifier un facteur de taille de pixel ou une taille de pixel en ré-échantillonnant votre cache d'élément.
| String |
request_size (Facultatif) |
Spécifiez la taille requise. La valeur indiquée dépend de l'option request_size_type. Si vous choisissez PIXEL_SIZE_FACTOR, votre facteur est un facteur d'échelle. Si vous choisissez PIXEL_SIZE, votre valeur est la taille en pixel après le ré-échantillonnage. | Double |
Exemple de code
Il s'agit d'un exemple Python de l'utilisation de l'outil BuildMosaicDatasetItemCache.
import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
"C:/Workspace/itemcache.gdb/md", "#", "DEFINE_CACHE",
"NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY",
"80", "#", "#")
Il s'agit d'un exemple de script Python de l'utilisation de l'outil BuildMosaicDatasetItemCache.
#Define mosaic dataset item cache without generating the cache file
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"
arcpy.BuildMosaicDatasetItemCache_management(
mdname, query, definecache, generatecache, cachepath, compression,
compquality, maxrow, maxcolumn)