ComputeFootprintByRadiometry

The ComputeFootprintByRadiometry ISCommand is used to redefine the footprint polyon for each raster dataset based on a valid pixel value range.

The command line is:

ISCommand ComputeFootprintByRadiometry --ISDef=<PathToISDef> --ImageRequestSize=<ImageRequestSize> --MaxNumVertices=<Approx. Number of vertices> --LutMinValue=<MinDataValue> --LutMaxValue=<MaxDataValue> --ShrinkDistance=<ShrinkDistance> --ShrinkDistanceUnit=<ShrinkDistanceUnit> --Refine=[TRUE|FALSE] --SkipDerivedImages=[TRUE|FALSE] --TemplateLocation=<PathToRadiometryTemplate> --NoData=<NoDataValue>

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

ImageRequestSize

Defines the approximate resolution in one direction of the image required for processing. Higher value can be defined for more accurate footprint but it takes longer to process.

2000

Yes

MaxNumVertices

Defines the maximum number of vertices in the footprint polygon. Weeding is performed to remove unnecessary vertices.

30

Yes

LutMinValue

Values less than this are considered NoData

1

Yes

LutMaxValue

Values greater than this are considered NoData

254

Yes

ShrinkDistance

Shrinks the rows and columns of the footprint

0

Yes

ShrinkDistanceUnit

The units of the shrink distance

Meter

Yes

SkipDerivedImages

This property should be false if the footprints of the derived images need to be recomputed

TRUE

Yes

Refine

This property should be false if the existing footprint is invalid.

FALSE

Yes

TemplateLocation

The processes applied to get a black white image are defined in the default template kept in the XADef folder. Users can define their own templates and define the location in this node. Apart from processes, any client side property can be defined in this template.

 

No

NoData

The NoData value specifies how "no measurement" values are denoted.

 

No

While computing the footprints by radiometry, the processes applied while extracting an image are now defined in a custom template. You can use these custom templates to modify the processes applied to an image before generating footprints and to define other client side properties. Additionally, you can also create your own custom templates. However, these templates can only be defined using an ISCommand.

For some services with specific colors around the edge of the image, better results can be obtained by modifying the image resolution.

Example:

ISCommand ComputeFootprintByRadiometry --ISDef=c:\Test1.ISDef\ImageService.ISDef --ImageRequestSize=2000 --MaxNumVertices=30 --LutMinValue=1 --LutMaxValue=254 --ShrinkDistance=0 --ShrinkDistanceUnit=Meter --Refine=TRUE --SkipDerivedImages=TRUE  --NoData=256