Calculates the statistics of overlapping cube regions
Overview
Parameters
Example 1
Description
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.
Fixed the formatting for a tab tabletype, improved documentation, and
added an example.
Christopher Austin
2008-11-10
The output file TO must now be specified.
Steven Lambright
2008-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 Austin
2008-10-28
Added error throwing when there are no overlaps among the cubes provided
and other small bug fixes.
Christopher Austin
2009-01-26
Added the ERRORS flat file.
Christopher Austin
2009-02-17
Added the DETAILS FULL output option. BRIEF is now what the application
use to result in.
Christopher Austin
2009-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 Austin
2009-06-05
Added the SINGLELINE parameter and changed the keywords SerialNumber* to
ImageStack*
Christopher Austin
2009-06-08
Removed the *Sum keywords from the BRIEF output, and added PolygonCount.
Jai Rideout
2011-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 Rideout
2011-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 Rideout
2012-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. Cook
2012-12-10
Changed to use TProjection instead of Projection. References #775
Jeannie Backer
2016-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
Determines how much detail is given in the output.
Type
string
Default
BRIEF
Option List:
Option
Brief
Description
BRIEF
Brief table
The ouput will be displayed on the screen and placed in the
print.prt file. The output will contain a table of statistics as
described in the application description, including Area and
Thickness statistics. If there are any cubes in the FROMLIST which
do not overlap any other cubes in the FROMLIST, they will be
listed at the bottom of the output. The number of polygons is also
recorded.
Exclusions
TO
TABLETYPE
SINGLELINE
FULL
Full data
In addition to the output of BRIEF, each overlap's Area,
Thickness, and all cubes that make up the overlap are written to
the file specified in the TO option. The format of the output can
be specified with the TABLETYPE option.
Places all cube serial numbers
and filenames on the same line in the output file. When False, Serial
Numbers and Filenames are placed in columns for better human
readability. This option is only available when the output is in CSV
format.
This file will contain the errors that occurred while calculating the
overlap statistics. Each line will contain the error message followed
by the serial number(s) of the cube(s) involved.
This example illustrates how to generate overlap statistics for the
following list of three overlapping cubes. overlapstats will calculate
the thickness, area, and image count for each of the overlapping
polygons that the cubes provided in cubes.lis create, and output these
results to stats.txt. Each value in the resulting table will be
separated by a tab.
This is the first input image for overlapstats to use
cube2.cub
Second image
This is the second input image
cube3.cub
Third image
This is the third input image
Overlapping Images
Overlap Visualization
This is not an input to the application, but it shows a
visual representation of the overlapping regions of the three cubes.
In this image, there are two overlapping regions.
The FULL output of overlapstats will be displayed and written to
the filename provided in the TO option. You will notice that there
are two different overlaps, which correspond with the two overlaps
present in the overlap visualization image (see below).