Import Tile Cache (Data Management)

Summary

Imports tiles from an existing tile cache or a tile package. The target cache must have the same tiling scheme, spatial reference, and storage format as the source tile cache.

Usage

  • Use this tool to import all or portions of a cache from one tile cache to another.

  • This tool supports the Parallel Processing environment setting.

Parameters

LabelExplanationData Type
Target Tile Cache

An existing tile cache to which the tiles will be imported.

Raster Layer
Source Tile Cache

An existing tile cache or a tile package from which the tiles are imported.

Raster Layer; File
Scales [Pixel Size] (Estimated Disk Space)
(Optional)

A list of scale levels at which tiles will be imported.

Double
Area of Interest
(Optional)

An area of interest will spatially constrain where tiles are imported into the cache.

This parameter is useful if you want to import tiles for irregularly shaped areas.

Feature Set
Overwrite Tiles
(Optional)

Determines whether the images in the destination cache will be merged with the tiles from the originating cache or overwritten by them.

  • Unchecked—When the tiles are imported, transparent pixels in the originating cache are ignored by default. This results in a merged or blended image in the destination cache. This is the default.
  • Checked—The import replaces all pixels in the area of interest, effectively overwriting tiles in the destination cache with tiles from the originating cache.
Boolean

Derived Output

LabelExplanationData Type
Updated Target Tile Cache

The updated tile cache.

Raster Layer

arcpy.management.ImportTileCache(in_cache_target, in_cache_source, {scales}, {area_of_interest}, {overwrite})
NameExplanationData Type
in_cache_target

An existing tile cache to which the tiles will be imported.

Raster Layer
in_cache_source

An existing tile cache or a tile package from which the tiles are imported.

Raster Layer; File
scales
[scales,...]
(Optional)

A list of scale levels at which tiles will be imported.

Double
area_of_interest
(Optional)

An area of interest will spatially constrain where tiles are imported into the cache.

This parameter is useful if you want to import tiles for irregularly shaped areas.

Feature Set
overwrite
(Optional)

Determines whether the images in the destination cache will be merged with the tiles from the originating cache or overwritten by them.

  • MERGEWhen the tiles are imported, transparent pixels in the originating cache are ignored by default. This results in a merged or blended image in the destination cache. This is the default.
  • OVERWRITEThe import replaces all pixels in the area of interest, effectively overwriting tiles in the destination cache with tiles from the originating cache.
Boolean

Derived Output

NameExplanationData Type
out_tile_cache

The updated tile cache.

Raster Layer

Code sample

ImportTileCache example 1 (Python window)

This is a Python sample for the ImportTileCache tool.

import arcpy

arcpy.ImportTileCache_management("C:/Data/CacheDatasets/Target", 
                                 "C:/Data/CacheDatasets/Source", 
                                 "4000;2000;1000", "#","MERGE")
ImportTileCache example 2 (stand-alone script)

This is a Python script sample for the ImportTileCache tool.

#Import tile cache for some levels from a pre-existing tile cache

import arcpy

    
cacheTarget = "C:/Data/CacheDatasets/Target"
cacheSource = "C:/Data/CacheDatasets/Source"
scales = "4000;2000;1000"
areaofinterest = "#"
overwrite = "MERGE"

arcpy.ImportTileCache_management(cacheTarget, cacheSource, scales, 
                                 areaofinterest, overwrite)

Environments

Special cases

Parallel Processing Factor

If the Parallel Processing Factor value is empty (blank), the tool will run with a default value of 50 percent (one-half) of the available cores.

Related topics