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

Dialog

Label	Explanation	Data 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

Label	Explanation	Data Type
Updated Target Tile Cache	The updated tile cache.	Raster Layer

Python

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

Name	Explanation	Data 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. MERGE—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. OVERWRITE—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

Name	Explanation	Data 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

Parallel Processing Factor

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.