Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


footprintinit

Standard View | TOC | Home

This program stores a polygon representing the Lat/Lon footprint of the image.

Description
Categories
Groups
History


Description

This program creates a latitude/longitude geometric polygon that determines the footprint of the image. This footprint is used in other programs such as autoseed.

Categories


Parameter Groups

Files

Name Description
FROM Input cube

Options

Name Description
SINC The accuracy of the footprint in the sample direction (larger is less accurate)
LINC The accuracy of the footprint in the line direction (larger is less accurate)
MAXEMISSION The maximum valid emission angle
MAXINCIDENCE The maximum valid incidence angle

Limb Test

Name Description
LIMBTESTDefines how limb images are to be handled

XY Test

Name Description
TESTXYTests the footprint's XY projection
MAP File containing mapping parameters

Files: FROM

Description

The cube to initialize polygons.

Type cube
File Mode input
Filter *.cub

Options: SINC

Description

This is approximately how many samples in the input image to skip for every point stored in the footprint.

Type integer
Default 100
Minimum 1 (inclusive)

Options: LINC

Description

This is approximately how many lines in the input image to skip for every point stored in the footprint.

Type integer
Default 100
Minimum 1 (inclusive)

Options: MAXEMISSION

Description

When this value is provided, footprintinit will only consider points with an emission angle less than or equal to the provided value. There should never be an emission angle above 90. However, planet features can cause abnormalities.

Type double
Internal Default Ignore Emission
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)

Options: MAXINCIDENCE

Description

When this value is provided, footprintinit will only consider points with an incidence angle less than or equal to the provided value. There should never be an incidence angle above 90. However, planet features can cause abnormalities.

Type double
Internal Default Ignore Incidence
Minimum 0.0 (inclusive)
Maximum 180.0 (inclusive)

Limb Test: LIMBTEST

Description

This parameter is used to specify how limb images are to be handled.

Type string
Default ELLIPSOID
Option List:
Option Brief Description
ELLIPSOIDUse an Ellipsoid Shape Model If a limb image is detected, an ellipsoid shape model will be used reguardless of the shape model defined by spiceinit.
SPICEINITUse Spiceinit Shape Model If a limb image is detected then use the shape model defined by spiceinit. This is

XY Test: TESTXY

Description

Tests the ability to project the footprint from lat/lon to x/y coordinates. If the test fails, an error will be thrown, and the lat/lon footprint will not be written to the input cube.

Type boolean
Default FALSE
Inclusions
  • MAP

XY Test: MAP

Description

A file containing the desired XY mapping parameters. This file can be a simple label file, hand produced or created via the "maptemplate" program. It can also be an existing cube label which contains a Mapping group. In the later case the input cube will be transformed into the same map projection, resolution, etc.

Type filename
File Mode input
Default Path $base/templates/maps
Default $base/templates/maps/sinusoidal.map
Filter *.map *.cub

History

Tracie Sucharski2005-07-19 Original version
Jacob Danton2006-02-10 Changed input from a list of cube files to a single cube and added appTest.
Brendan George2006-06-30 Fixed application test
Brendan George2006-09-19 Added call to propagate and modify the history blob
Tracie Sucharski2007-05-09 Added error check to insure spiceinit has been run.
Brendan George2007-05-21 Moved from Geometry category to Control Network category
Steven Lambright2007-07-26 Moved Control Network category to Control Networks Category (Control Network category is invalid) and updated program description.
Steven Koechle2007-10-19 Changed name from polyinit to footprint init
Steven Koechle2008-08-19 Updated to work with Geos3.0.0
Steven Koechle2008-12-15 Deletes old footprint (generated off cubes serial number) if its found. New name for blob is just Footprint.
Steven Koechle2009-04-17 PIXINC parameter was removed, ImagePolygon now uses a new method of finding footprints
Steven Lambright2009-05-29 PIXINC re-implemented. This functionality is crucial. Existing polygons will no longer be deleted if this program fails.
Christopher Austin2009-06-16 Changed default PIXINC to 100, added test cases.
Christopher Austin2009-06-18 Added the cross test.
Christopher Austin2009-07-01 Added EMISSION and INCIDENCE
Christopher Austin2009-07-09 Changed param EMISSION to MAXEMISSION, and INCIDENCE to MAXINCIDENCE.
Christopher Austin2009-07-21 Added LIMBTEST parameter, and fixed multiple tests, including multiple PIXINC coverage.
Christopher Austin2009-07-28 Replaced PIXINC with SAMPINC and LINEINC.
Christopher Austin2009-08-05 Changed the maximum value of MAXEMISSION and MAXINCIDENCE to 180. Added TESTXY and an app test for it.
Christopher Austin2009-08-20 Changed SAMPINC and LINEINC to SINC and LINC for consistancy with camstats.