Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

overlapstats

Standard View | TOC | Home

Calculates the statistics of overlapping cube regions

Description
Categories
Groups
Examples
History

Description

Taking a list of cubes and an image overlap list file from "findimageoverlaps", this application determines the statistics on all overlapping polygons of those provided images, and displays those values in the print.prt file. Note that the units of Area is square meters, and Image is images per polygon.

In addition, if there are any cubes within the list that do not overlap with any other cube in the list, those cube's filenames and Serial Numbers will included at the end if the output given to the print.prt file.

Categories

Parameter Groups

Input Files

Name Description
FROMLIST List of Input cubes
OVERLAPLIST This is the list of image overlaps corresponding to this control net

Output

Name Description
DETAILOutput data content
TO Output stats file
TABLETYPEOutput data format
SINGLELINE Place all Serial Numbers on the same CVS line
ERRORS Errors generated when calculating the overlap stats

Input Files: FROMLIST

Description

The filename which contains a list of input cubes.

Type filename
File Mode input
Filter *.lis

Input Files: OVERLAPLIST

Description

Use this parameter to select the filename which contains the overlap list. You can obtain this file by running "findimageoverlaps."

Type filename
File Mode input
Filter *

Output: DETAIL

Description

Determines how much detail is given.

Type string
Default BRIEF
Option List:
Option Brief Description
BRIEFBrief Table The ouput will be displayed and placed in the print.prt file, containing 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 PVL Group.

Exclusions

  • TO
  • TABLETYPE
  • SINGLELINE
FULLFull Data This option includes the same output as the BRIEF option. In addition, it places in the TO file a listing of all overlaps with each overlap's Area, Thickness, and all cubes that make up that overlap.

Inclusions

  • TO
  • TABLETYPE

Output: TO

Description

The table file of the detailed stats of each overlap.

Type filename
File Mode output

Output: TABLETYPE

Description

The resultant statistics of the overlaps will be formatted in accordance to the following option.

Type string
Default CSV
Option List:
Option Brief Description
TAB Tab Table Places the resulting statistics into an easy to read table, which displays values seperates by tabs.

Exclusions

  • SINGLELINE
CSVCSV Output the resulting statistics into Comma Seperated Value (CSV) format.

Inclusions

  • SINGLELINE

Output: SINGLELINE

Description

When True, places all Serial Numbers and Filenames on the same line in the output CVS file. When False, Serial Numbers and Filenames are placed in columns for readability.

Type boolean
Default TRUE

Output: ERRORS

Description

This file will contain the errors that occurred while calculating the overlap stats.

Type filename
File Mode output
Internal Default No Error Output

Examples

Example 1

Overlapping Statistics

Description

Get the overlapping statistics of the following cubes.

Command Line

overlapstats from=cubes.lis overlpalist=overlaps.dat
In this example overlapstats will calculate the statistics of the thickness, area, and serial number count of the overlapping polygons that the cubes provided in cubes.lis create, and output those results into the print.prt file.

Input Images

cube.1.cube

First image

This is the first input image for the overlapstats to use

cube.2.cub

Second image

This is the second input image

cube.3.cub

Third image

This is the third input image

Data Files

The list of cubes to use This is the input list of cubes to use to create the overlap which the statistics will be ran on.
The resultant stats The stats of overlapstats will be displayed and sent to print.prt.

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.