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
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.
The output file TO must now be specified.
Added support for image overlap files, which is what "OVERLAPLIST" needs
to be. This is a required parameter obtained from running
Added error throwing when there are no overlaps among the cubes provided
and other small bug fixes.
Added the ERRORS flat file.
Added the DETAILS FULL output option. BRIEF is now what the application
use to result in.
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.
Added the SINGLELINE parameter and changed the keywords SerialNumber* to
Removed the *Sum keywords from the BRIEF output, and added PolygonCount.
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.
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.
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
Debbie A. Cook
Changed to use TProjection instead of Projection. References #775
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.
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
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
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.
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).