BuildService

The BuildService ISCommand builds an image service definition, including computing minimum and maximum pixel sizes, validating the rasters, computing output properties, generating histogram, and generating the boundary. You can override these parameters by specifying them in the command line.

The default command line is:

ISCommand BuildService --ISDef=<PathToISDef> --ValidateRasterSrc=[True|False] --ValidateRPDefs=[True|False] --OutputProperties=[True|False] --ViewPointShift=[True|False] --ComputePixelSizeRanges=[True|False] --ExtractMetaFields=[True|False] --DeriveBoundary=[True|False] --DeriveImages=[True|False]

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, which you want to build.

User specified

Yes

ValidateRasterSrc

When True, raster sources are checked to ensure that they are valid raster datasets.

False, True

False

No

ValidateRPDefs

When True, the process checks that the correct processes are defined in the raster process definition (.RPDef) files.

False, True

False

No

OutputProperties

This is set to True when you want to calculate the output pixel properties or if you have made any changes to the service processes.

True, False

True

No

ViewPointShift

This is set to True when you are building an image service and you want to use the Viewpoint interface control to shift the apparent viewpoint center of the image service.

False, True

False

No

ComputePixelSizeRanges

When set to True, this option computes the minimum and maximum pixel size ranges assigned to each raster dataset.

True, False

True

No

ExtractMetaFields

When set to True, this extracts any additional metadata provided with the raster data in the image service definition and saves in the service table.

False, True

Note: Ensure that the footprint table is currently not under any open edit sessions in ArcMap to see the extracted metadata changes in the service table.

False

No

DeriveBoundary

When set to True, this generates a boundary shapefile containing all the raster datasets in the image service definition.

True, False

True

No

DeriveImages

When set to True, this generates any optimization images that have been created (derived).

False, True

False

No

Example:

ISCommand BuildService --ISDef=c:\Test2.ISDef\ImageService.ISDef -ValidateRasterSrc=True --ValidateRPDefs=False --OutputProperties=False --ViewPointShift=False --ComputePixelSizeRanges=True --ExtractMetaFields=False --DeriveBoundary=True --DeriveImages=False