DefineDerivedTiles

The DefineDerivedTiles ISCommand is used to define derived tiles for an image service definition. You must specify the area where you would like the derived tiles to be defined, which can only be rectangular. You can override parameters, such as the area of interest, compression method, tile size, and compression quality and output image location. By default, the derived images will be generated in the same location where the image service definition is located.

The default command line is:

ISCommand DefineDerivedTiles --ISDef=<PathToISDef> --OutputFolder=<OutputFolder> --XMin=<XMin> --YMin=<YMin> --XMax=<XMax> --YMax=<YMax> --OptimumNRows=<OptimumNRows> --OptimumNCols=<OptimumNCols> --FormatName=<FormatName> --CompressionMethod=<CompressionMethod> --CompressionQuality=<CompressionQuality> --TileSize=<TileSize> --PixelSize=<PixelSize> --SamplingMethod=<SamplingMethod>

The table below defines the variables that are required to use this script. Most variables are defined within the script. You can either make an edit to the script or enter the variable at the command line as shown below.

Variable

Description/Options

Default

Required

ISDef

Path and name of the image service definition file.

User specified

Yes

OutputFolder

Path and name of the output folder.

User specified

Yes

XMin

Leftmost X co-ordinate of the set extent.

User specified

Yes

YMin

Bottommost Y co-ordinate of the set extent.

User specified

Yes

XMax

Rightmost X co-ordinate of the set extent.

User specified

Yes

YMax

Topmost Y co-ordinate of the set extent.

User specified

Yes

OptimumNRows

Optimum number of rows of pixels in the image.

5120

No

OptimumNCols

Optimum number of columns of pixels in the image.

5120

No

FormatName

Format to be used for the creation of derived rasters.

•TIFF, JPEG2000

TIFF

Yes

CompressionMethod

Method of compression used for the creation of derived tiles.

•JPEG, LZ77

JPEG

No

CompressionQuality

Quality of the compression.

•0-100

80

No

TileSize

Size of tiles in the exported image for TIFF images only.

•0, 64, 128, 256, 512, 1024

256

No

PixelSize

Pixel size used to create the derived tiles.

 

No

SamplingMethod

Name of the sampling method that defines how the pixels in the rasters are resampled to match the resolution of the AOI.

•Nearest Neighbor—This method is useful for discrete data (such as land uses, or soil types)
•Bilinear—This method is useful for continuous data (such as elevation), giving the smoothest appearance to your data.
•BiCubic—This method is also useful for continuous data, giving a sharper appearance to your data than Bilinear Interpolation.

Bilinear

No

Example:

ISCommand DefineDerivedTiles --ISDef=c:\Test.ISDef\ImageService.ISDef --OutputFolder=d:\rasters --XMin=4489257.029519 --YMin=5478797.299961 --XMax=4489491.679228 --YMax=5478991.492823 --OptimumNRows=5120 --OptimumNCols=5120 --FormatName=TIFF --CompressionMethod= JPEG --CompressionQuality=80 --TileSize=256 --PixelSize=0.1 --SamplingMethod=Bilinear