ISIS Documentation

overlapstats

Calculates the statistics of overlapping cube regions

This application takes a list of cubes and an image overlap list file from the output of findimageoverlaps and calculates statistics on all overlapping polygons of the provided images, writing the results to an output file. The statistics generated by this application may provide useful information for choosing parameters for the autoseed application. Images must be ingested into ISIS and have spiceinit, footprintinit, and findimageoverlaps run to produce the input for this application.

Statistics for the area, polygon thickness, and image stack size of the polygons are calculated. These statistics include minimum, maximum, average, standard deviation, and variance. Area refers to the area of the polygon in square meters. Image stack is the number of images that overlap for a given overlap region.

If there are any cubes within the list that do not overlap with any other cube in the list, those cube's filenames are included at the end of the output in the NoOverlap PVL keyword.


Categories


History

Christopher Austin2008-09-30 Original version
Christopher Austin2008-10-28 Fixed the formatting for a tab tabletype, improved documentation, and added an example.
Christopher Austin2008-11-10 The output file TO must now be specified.
Steven Lambright2008-11-17 Added support for image overlap files, which is what "OVERLAPLIST" needs to be. This is a required parameter obtained from running "findimageoverlaps."
Christopher Austin2008-10-28 Added error throwing when there are no overlaps among the cubes provided and other small bug fixes.
Christopher Austin2009-01-26 Added the ERRORS flat file.
Christopher Austin2009-02-17 Added the DETAILS FULL output option. BRIEF is now what the application use to result in.
Christopher Austin2009-03-05 Altered the DETAILS FULL and BRIEF options based off of user input. Now, the statistical data will always be placed in the print.prt file, and the TO file will only be used for the detailed output of the overlaps.
Christopher Austin2009-06-05 Added the SINGLELINE parameter and changed the keywords SerialNumber* to ImageStack*
Christopher Austin2009-06-08 Removed the *Sum keywords from the BRIEF output, and added PolygonCount.
Jai Rideout2011-09-26 Updated and rewrote much of the existing documentation with Raad Saleh and Laszlo Kestay to match the current behavior of the application, as well as clarify the purpose of the application.
Jai Rideout2011-12-26 Added check to ensure the provided cube list is the same one used in findimageoverlaps (i.e. the serial numbers in the overlap list match the serial numbers in the provided cube list). Fixes #515.
Jai Rideout2012-01-18 The errors file now contains a newline at the end. The error count is now calculated regardless of whether or not the ERRORS parameter was specified.
Debbie A. Cook2012-12-10 Changed to use TProjection instead of Projection. References #775
Jeannie Backer2016-04-22 Modified code to get TargetRadii using the cube label and mapping group rather than just the TargetName. Added TargetName keyword to Mapping group. References #3892