Créer un cache d'éléments de mosaïque (Gestion des données)

Synthèse

Insère la fonction Raster en cache comme étape finale dans toutes les chaînes de fonctions au sein 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'activez pas le paramètre Générer le cache (définissez generate_cache sur GENERATE_CACHE dans Python) pour générer le cache, vous pouvez utiliser l'outil Synchroniser une mosaïque.

  • 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. 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.

Paramètres

ÉtiquetteExplicationType de données
Mosaïque

Mosaïque à laquelle vous voulez appliquer la fonction de cache.

Mosaic Layer
Ensemble de définition
(Facultatif)

Expression SQL permettant de sélectionner des jeux de données raster dans la mosaïque sur laquelle vous souhaitez que le cache d’élément soit généré.

SQL Expression
Définir le cache
(Facultatif)

Activez la mise à jour dans les propriétés du cache.

  • Activé : la fonction Raster en cache est ajoutée aux éléments sélectionnés. Si un élément contient déjà cette fonction, l'outil n'en ajoute pas d'autre. Il s’agit de l’option par défaut.
  • Désactivé – Aucun cache raster n'est défini.
Boolean
Générer le 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.

  • Activé - Le cache est généré. Il s’agit de l’option par défaut.
  • Désactivé - Le cache n'est pas généré.
Boolean
Chemin d'accès au cache
(Facultatif)

Remplacez l'emplacement par défaut pour enregistrer votre cache. Si la mosaïque se trouve à l'intérieur d'une géodatabase fichier, le cache est enregistré par défaut dans un dossier de même nom que la géodatabase et une extension .cache. Si la mosaïque est à l'intérieur d'une géodatabase d'entreprise, le cache est enregistré par défaut à l'intérieur de cette géodatabase. Une fois créé, le cache est toujours enregistré à cet emplacement. Pour enregistrer le cache dans un autre emplacement, vous devez d'abord utiliser l'outil Réparer la mosaïque pour spécifier un nouvel emplacement, puis réexécuter cet outil.

Une fois qu'un cache d'élément est créé, il est impossible de le régénérer dans un autre emplacement en spécifiant un chemin de cache différent 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
Méthode de compression
(Facultatif)

Choisissez le mode de compression de vos données pour accélérer la transmission.

  • LOSSLESS Conservez les valeurs de chaque pixel lors de la génération du cache. La compression sans perte a un taux d'environ 2:1.
  • LOSSY Cette compression convient si votre imagerie est uniquement utilisée en arrière-plan. La compression avec perte dispose du taux de compression le plus élevé (20:1), mais regroupe les valeurs de pixel similaires afin d'améliorer la compression.
  • NONE Ne compressez pas l'imagerie. Cela ralentit la transmission de votre imagerie, mais accélère son affichage, car elle n'a pas besoin d'être décompressée pour être visionnée.
String
Qualité de compression
(Facultatif)

Définissez une qualité de compression lorsque vous utilisez la méthode avec perte. La valeur de qualité de compression est comprise entre 1 et 100 pour cent, 100 correspondant à la compression la moins élevée.

Long
Nombre maximum de lignes autorisées
(Facultatif)

Limitez la taille du jeu de données de cache par le nombre de lignes. Si la valeur est supérieure au nombre de lignes dans le jeu de données, le cache n'est pas généré.

Long
Nombre maximum de colonnes autorisées
(Facultatif)

Limitez la taille du jeu de données de cache par le nombre de colonnes. Si la valeur est supérieure au nombre de colonnes dans le jeu de données, le cache n'est pas généré.

Long
Type de taille requis
(Facultatif)

Rééchantillonnez le cache à l'aide de l'une des deux méthodes suivantes :

  • PIXEL_SIZE_FACTOR Définissez un facteur d'échelle en rapport avec la taille de pixel. Pour ne pas rééchantillonner le cache, choisissez Facteur de la taille de pixel et définissez le paramètre Taille requise sur 1.
  • PIXEL_SIZE Spécifiez une taille de pixel pour le raster en cache.
String
Taille requise
(Facultatif)

Définissez la valeur à appliquer au type de taille requis.

Double

Sortie obtenue

ÉtiquetteExplicationType de données
Mosaïque mise à jour

Jeu de données mosaïque mis à jour.

Couche de mosaïque

arcpy.management.BuildMosaicDatasetItemCache(in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})
NomExplicationType de données
in_mosaic_dataset

Mosaïque à laquelle vous voulez appliquer la fonction de cache.

Mosaic Layer
where_clause
(Facultatif)

Expression SQL permettant de sélectionner des jeux de données raster dans la mosaïque sur laquelle vous souhaitez que le cache d’élément soit généré.

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.

  • DEFINE_CACHELa fonction Raster en cache est ajoutée aux éléments sélectionnés. Si un élément contient déjà cette fonction, l'outil n'en ajoute pas d'autre. Il s’agit de l’option par défaut.
  • NO_DEFINE_CACHEAucun cache raster n'est défini.
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.

  • GENERATE_CACHELe cache est généré. Il s’agit de l’option par défaut.
  • NO_GENERATE_CACHELe cache n'est pas généré.
Boolean
item_cache_folder
(Facultatif)

Remplacez l'emplacement par défaut pour enregistrer votre cache. Si la mosaïque se trouve à l'intérieur d'une géodatabase fichier, le cache est enregistré par défaut dans un dossier de même nom que la géodatabase et une extension .cache. Si la mosaïque est à l'intérieur d'une géodatabase d'entreprise, le cache est enregistré par défaut à l'intérieur de cette géodatabase. Une fois créé, le cache est toujours enregistré à cet emplacement. Pour enregistrer le cache dans un autre emplacement, vous devez d'abord utiliser l'outil Réparer la mosaïque pour spécifier un nouvel emplacement, puis réexécuter cet outil.

Une fois qu'un cache d'élément est créé, il est impossible de le régénérer dans un autre emplacement en spécifiant un chemin de cache différent 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)

Choisissez le mode de compression de vos données pour accélérer la transmission.

  • LOSSLESS Conservez les valeurs de chaque pixel lors de la génération du cache. La compression sans perte a un taux d'environ 2:1.
  • LOSSY Cette compression convient si votre imagerie est uniquement utilisée en arrière-plan. La compression avec perte dispose du taux de compression le plus élevé (20:1), mais regroupe les valeurs de pixel similaires afin d'améliorer la compression.
  • NONE Ne compressez pas l'imagerie. Cela ralentit la transmission de votre imagerie, mais accélère son affichage, car elle n'a pas besoin d'être décompressée pour être visionnée.
String
compression_quality
(Facultatif)

Définissez une qualité de compression lorsque vous utilisez la méthode avec perte. La valeur de qualité de compression est comprise entre 1 et 100 pour cent, 100 correspondant à la compression la moins élevée.

Long
max_allowed_rows
(Facultatif)

Limitez la taille du jeu de données de cache par le nombre de lignes. Si la valeur est supérieure au nombre de lignes dans le jeu de données, le cache n'est pas généré.

Long
max_allowed_columns
(Facultatif)

Limitez la taille du jeu de données de cache par le nombre de colonnes. Si la valeur est supérieure au nombre de colonnes dans le jeu de données, le cache n'est pas généré.

Long
request_size_type
(Facultatif)

Rééchantillonnez le cache à l'aide de l'une des deux méthodes suivantes :

  • PIXEL_SIZE_FACTOR Définissez un facteur d'échelle en rapport avec la taille de pixel. Pour ne pas rééchantillonner le cache, choisissez PIXEL_SIZE_FACTOR et définissez le paramètre request_size sur 1.
  • PIXEL_SIZE Spécifiez une taille de pixel pour le raster en cache.
String
request_size
(Facultatif)

Définissez la valeur à appliquer à request_size_type.

Double

Sortie obtenue

NomExplicationType de données
out_mosaic_dataset

Jeu de données mosaïque mis à jour.

Couche de mosaïque

Exemple de code

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

Il s'agit d'un exemple de script Python pour BuildMosaicDatasetItemCache.

import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
     "C:/Workspace/itemcache.gdb/md",  "#", "DEFINE_CACHE", 
     "NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY", 
     "80", "#", "#")
Exemple 2 d'utilisation de l'outil BuildMosaicDatasetItemCache (fenêtre autonome)

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

Rubriques connexes