ISIS Application Documentation
footprintinit | Printer Friendly View | TOC | Home |
Creates a lat/lon polygon and writes it to the image
| Overview | Parameters |
DescriptionThis applications creates a geometric polygon ("footprint") of the input image, where each vertex is a latitude/longitude coordinate in the image. Depending on the granularity of the search (SINC/LINC, NUMVERTICES), this polygon can represent anything from a rough approximation to a fine-grained model of the latitude/longitude extents of the image. These polygons are used in a variety of ISIS applications, primarily for performing fast intersection tests to determine if a given coordinate or line falls within the bounds of an image in latitude/longitude space. Because many applications can see performance gains on the order of magnitudes from using polygons over repeatedly creating cameras, it is highly recommended that this application be run on all images in a control network prior to performing network population. The application "autoseed" requires the presence to these polygons, while "cnetadd" has a significant optimization in place using polygons. The application "spiceinit" must be run prior to running this application. CategoriesRelated Objects and DocumentsApplicationsHistory
|
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:10 |
Parameter GroupsFiles
Options
Limb Test
XY Test
|
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:10 |
Files: FROM
Description
The cube to initialize polygons.
| Type | cube |
|---|---|
| File Mode | input |
| Filter | *.cub |
Options: INCREASEPRECISION
Description
Enabeling this option will allow the automatic reduction of the SINC and LINC parameters whenever their current values result in an invalid polygon. In addition, a results group will be created with the keywords SINC/LINC which reveal what SINC/LINC values were actually used for the creation of the footprint. NOTE: This parameter can result in a drastic increase in running time as well as a change to user input values.
| Type | boolean |
|---|---|
| Default | FALSE |
Options: INCTYPE
Description
When true, use NUMVERTICES to set an approximate number of steps for the footprint. Otherwise use POLYLINC and POLYSINC to create the polygon based on the dimentions of the cube.
| Type | string | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Default | LINCSINC | |||||||||
| Option List: |
|
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: 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: NUMVERTICES
Description
Specifies the approximate number of vertices (+/- 3) to take around the image to compute the polygon footprint. (In limb images, the number of steps can be much more or less than 3 off.) Note that currently, an increment of 4 or less will not work for pushframe instruments such as THEMIS-VIS.
| Type | integer |
|---|---|
| Default | 40 |
| Minimum | 4 (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: |
|
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 |
|
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 | $ISISROOT/appdata/templates/maps |
| Default | $ISISROOT/appdata/templates/maps/sinusoidal.map |
| Filter | *.map *.cub |