Gérer le cache de tuiles (Gestion des données)

Synthèse

Crée un cache de tuiles ou actualise des tuiles dans un cache de tuiles existant. Vous pouvez utiliser cet outil pour créer des tuiles, remplacer des tuiles manquantes, actualiser des tuiles devenues obsolètes et supprimer des tuiles.

Utilisation

  • Il peut arriver que l’étendue du cache généré soit supérieure à la valeur du paramètre Zone d’intérêt. Dans ce cas, l’outil divise les données en zones de grande taille, connues sous le nom de super tuiles, avant de les découper en tuiles de la taille spécifiée. Lorsque la valeur du paramètre Source de données en entrée utilise l’anticrénelage, la taille de la super tuile est de 2 048 pixels sur 2 048. Sinon, la taille est de 4 096 pixels sur 4 096. Lorsque l’entité Zone d’intérêt définie intersecte la limite d’une super tuile, l’intégralité de cette super tuile est créée. Cela signifie qu’un zoom avant peut être nécessaire pour réellement constater un gain de temps et d’espace disque grâce à la mise en cache par une classe d’entités. Si vous possédez plusieurs zones d’intérêt et qu’elles couvrent la majorité de la valeur du paramètre Source de données en entrée, il est possible que l’avantage de la mise en cache par classe d’entités soit limité, car la plupart des entités intersectent une super tuile.

  • Pour créer un cache dans une structure de tuilage personnalisée, vérifiez qu’une structure de tuilage est définie pour le jeu de données source avant d’utiliser cet outil. Vous pouvez utiliser l'outil Générer la structure de tuilage du cache de tuiles pour créer la structure de tuilage.

  • Cet outil prend en charge le paramètre d'environnement Traitement parallèle.

Paramètres

ÉtiquetteExplicationType de données
Emplacement du cache

Dossier dans lequel le jeu de données du cache est créé, couche raster ou chemin d’accès à un cache de tuiles existant.

Folder; Raster Layer
Mode de gestion

Indique le mode à utiliser pour gérer le cache.

  • RECREATE_ALL_TILESToutes les tuiles sont remplacées. De nouvelles tuiles sont créées si nécessaire du fait de la modification de l'étendue ou de l'ajout de nouvelles couches dans le cas d'un cache multi-couches.
  • RECREATE_EMPTY_TILESSeules les tuiles vides sont créées. Les tuiles existantes restent en l'état.
  • DELETE_TILESLes tuiles sont supprimées du cache. La structure du dossier de cache n'est pas supprimée.
String
Nom du cache
(Facultatif)

Nom du jeu de données du cache à créer dans l’emplacement du cache.

String
Structure de tuilage en entrée
(Facultatif)

Indique la structure de tuilage utilisée.

String
Importer la structure de tuilage
(Facultatif)

Chemin d’accès vers un fichier de structure existant (.xml) ou importé à partir d’un service d’imagerie ou de carte existant.

Image Service; Map Server; File
Echelles [Taille de pixel] (Espace disque estimé)
(Facultatif)

Niveaux d’échelle auxquels les tuiles sont créées ou supprimées, selon la valeur du paramètre Mode de gestion. La taille de pixel repose sur la référence spatiale de la structure de tuilage.

  • Par défaut, seules les valeurs des paramètres Échelle mise en cache minimale et Échelle mise en cache maximale sont utilisées.
  • La modification de la valeur du paramètre Échelle mise en cache minimale ou Échelle mise en cache maximale a pour effet d'activer ou de désactiver les valeurs d'échelle appropriées.
  • Les échelles qui sont activées et qui ne se trouvent pas dans la plage des valeurs du paramètre Échelle mise en cache minimale ou Échelle mise en cache maximale sont ignorées lorsque le cache est généré.
Double
Zone d'intérêt
(Facultatif)

Définit une zone d'intérêt pour contraindre l'emplacement où les tuiles seront créées ou supprimées.

Il peut s'agir d'une classe d'entité ou d'une entité que vous définissez de manière interactive.

Ce paramètre est utile si vous souhaitez gérer des tuiles pour les zones de forme irrégulière. Il permet également de mettre certaines zones en cache et de conserver telles quelles les zones moins visitées qui n’ont pas été mises en cache.

Feature Set
Taille maximale de la cellule source
(Facultatif)

Valeur qui définit la visibilité de la source de données pour laquelle le cache va être généré. Par défaut, la valeur est vide.

Si la valeur est vide, le comportement suivant s’applique :

  • Pour les niveaux de cache situés dans les plages de visibilité de la source de données, le cache est généré à partir de la source de données.
  • Pour les niveaux de cache qui ne sont pas situés dans les plages de visibilité de la source de données, le cache est généré à partir du niveau de cache précédent.

Si la valeur est supérieure à zéro, le comportement suivant s’applique :

  • Pour les niveaux dont les tailles de cellule sont inférieures ou égales à la valeur Taille maximale de la cellule source (max_cell_size), le cache est généré à partir de la source de données.
  • Pour les niveaux dont les tailles de cellule sont supérieures à la valeur Taille maximale de la cellule source (max_cell_size), le cache est généré à partir du niveau de cache précédent.

L'unité de la valeur Taille maximale de la cellule source doit être la même que l'unité de la taille de cellule du jeu de données source.

Double
Echelle mise en cache minimale
(Facultatif)

Échelle minimale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de la plus petite échelle de la structure de tuilage. L’échelle minimale du cache détermine les échelles utilisées lorsque le cache est généré.

Double
Echelle mise en cache maximale
(Facultatif)

Échelle maximale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de l’échelle la plus grande de la structure de tuilage. L'échelle maximale de votre cache détermine les échelles utilisées lorsque le cache est généré.

Double

Sortie obtenue

ÉtiquetteExplicationType de données
Nom du cache

Jeu de données du cache à créer dans l’emplacement du cache en sortie.

Raster Dataset

arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale})
NomExplicationType de données
in_cache_location

Dossier dans lequel le jeu de données du cache est créé, couche raster ou chemin d’accès à un cache de tuiles existant.

Folder; Raster Layer
manage_mode

Indique le mode à utiliser pour gérer le cache.

  • RECREATE_ALL_TILESToutes les tuiles sont remplacées. De nouvelles tuiles sont créées si nécessaire du fait de la modification de l'étendue ou de l'ajout de nouvelles couches dans le cas d'un cache multi-couches.
  • RECREATE_EMPTY_TILESSeules les tuiles vides sont créées. Les tuiles existantes restent en l'état.
  • DELETE_TILESLes tuiles sont supprimées du cache. La structure du dossier de cache n'est pas supprimée.
String
in_cache_name
(Facultatif)

Nom du jeu de données du cache à créer dans l’emplacement du cache.

String
tiling_scheme
(Facultatif)

Indique la structure de tuilage utilisée.

String
import_tiling_scheme
(Facultatif)

Chemin d’accès vers un fichier de structure existant (.xml) ou importé à partir d’un service d’imagerie ou de carte existant.

Image Service; Map Server; File
scales
[scale,...]
(Facultatif)

Niveaux d’échelle auxquels les tuiles sont créées ou supprimées, selon la valeur du paramètre manage_mode. La taille de pixel repose sur la référence spatiale de la structure de tuilage.

  • Par défaut, seules les valeurs des paramètres min_cached_scale et max_cached_scale sont utilisées lorsque le cache est généré.
  • La modification de la valeur du paramètre min_cached_scale ou max_cached_scale a un impact sur les échelles utilisées lorsque le cache est généré.
  • Les échelles qui ne se trouvent pas dans la plage des valeurs du paramètre min_cached_scale ou max_cached_scale sont ignorées lorsque le cache est généré.
Double
area_of_interest
(Facultatif)

Définit une zone d'intérêt pour contraindre l'emplacement où les tuiles seront créées ou supprimées.

Il peut s'agir d'une classe d'entité ou d'une entité que vous définissez de manière interactive.

Ce paramètre est utile si vous souhaitez gérer des tuiles pour les zones de forme irrégulière. Il permet également de mettre certaines zones en cache et de conserver telles quelles les zones moins visitées qui n’ont pas été mises en cache.

Feature Set
max_cell_size
(Facultatif)

Valeur qui définit la visibilité de la source de données pour laquelle le cache va être généré. Par défaut, la valeur est vide.

Si la valeur est vide, le comportement suivant s’applique :

  • Pour les niveaux de cache situés dans les plages de visibilité de la source de données, le cache est généré à partir de la source de données.
  • Pour les niveaux de cache qui ne sont pas situés dans les plages de visibilité de la source de données, le cache est généré à partir du niveau de cache précédent.

Si la valeur est supérieure à zéro, le comportement suivant s’applique :

  • Pour les niveaux dont les tailles de cellule sont inférieures ou égales à la valeur Taille maximale de la cellule source (max_cell_size), le cache est généré à partir de la source de données.
  • Pour les niveaux dont les tailles de cellule sont supérieures à la valeur Taille maximale de la cellule source (max_cell_size), le cache est généré à partir du niveau de cache précédent.

L'unité de la valeur Taille maximale de la cellule source doit être la même que l'unité de la taille de cellule du jeu de données source.

Double
min_cached_scale
(Facultatif)

Échelle minimale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de la plus petite échelle de la structure de tuilage. L’échelle minimale du cache détermine les échelles utilisées lorsque le cache est généré.

Double
max_cached_scale
(Facultatif)

Échelle maximale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de l’échelle la plus grande de la structure de tuilage. L'échelle maximale de votre cache détermine les échelles utilisées lorsque le cache est généré.

Double

Sortie obtenue

NomExplicationType de données
out_cache_location

Jeu de données du cache à créer dans l’emplacement du cache en sortie.

Raster Dataset

Exemple de code

Exemple 1 d'utilisation de l'outil Gérer le cache de tuiles (fenêtre Python)

Il s'agit d'un exemple Python d'utilisation de l'outil ManageTileCache.

import arcpy
            
arcpy.ManageTileCache_management(
      "C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
      "C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
      "#", "#", "#", "40000", "2000")
Exemple 2 d'utilisation de l'outil Gérer le cache de tuiles (script autonome)

Il s'agit d'un exemple de script Python d'utilisation de l'outil ManageTileCache.

#Generate tile cache for 3 out of 5 levels defined in tiling scheme

import arcpy

folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)

Environnements

Cas particuliers

Facteur de traitement parallèle

Si la valeur Facteur de traitement parallèle est vide (non renseignée), l'outil s'exécute avec la valeur par défaut 50 % (la moitié) des cœurs disponibles.

Rubriques connexes