ISIS Application Documentation
Sets problem measures to ignored based on an examination of the residual histogram.
Description
After jigsaw has done a bundle adjustment on a group of overlapping Isis, level
1, cubes every image measure in the network will have associated residuals.
A historgram of the residuals is constructed in order to determine the magnitude at which
the noise (bad data) starts to dominate the solution. The points are segregated into three
categories in assending order of residual magnitude: inocent, suspect, and guilty. The
progam then attempts to ingore all the suspect and guilty measures based on the criteria
for measure rejection provided. If guilty measures cannot be ingored a report is generated
documenting why. No additional action is taken if suspect measure cannot be elliminated.
Known Issues
Not spliting a network into islands is one of the primary considerations for whether
or not a measure can be ingorned. However, having even a single measure conecting mass of
images A to mass of image B is currently considered sufficient for 'connecting' them together
as a network. Obviously this is a necissary, though grossly insufficient requirment.
Categories
Applications
History
Orrin Thomas | 2012-04-13 |
Original version
|
|
Parameter Groups
Files
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts
Name
|
Description
|
BIN_WIDTH | The width of the histogram bins in unweighted pixels. |
SUSPECT_BUMP_PERCENT | The percent that that a local histogram maximum must be greater than a local minimum to be considered suspect. |
GUILTY_BUMP_PERCENT | The percent that that a local histogram maximum must be greater than a local minimum to be considered guilty. |
SUSPECT_FLOOR | There will be no attempt to set residuals smaller than this user defined limit to ignored. |
GUILTY_FLOOR | Every residual greater than user defined GUILTY_FLOOR is guilty |
Measure Rejection Criteria
|
Files:
FROMLIST
Description
This file contains a list of all cubes in the control network
Type
| filename |
File Mode
| input |
Filter
|
*.txt *.lis
|
Files:
CNET
Description
This file is a control network generated from programs such as
autoseed or qnet. It contains the control points
and associated measures.
Type
| filename |
File Mode
| input |
Filter
|
*.net
|
Files:
ONET
Description
This output file contains the updated control network with
the problem measures set to ignor.
Type
| filename |
File Mode
| output |
Filter
|
*.net
|
Files:
FILE_PREFIX
Description
2 Reports will be generated:
1. FILE_PREFIXGuilty.csv, a report of apparently bad points that could not be set to ignored,
2. FILE_PREFIXIgnored.csv, a report of all the measures that were set to ignor.
Type
| string |
Internal Default
| none |
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts:
BIN_WIDTH
Description
The program will build and analyze a histogram of the R^2 residual lengths.
This prameter tells the software how wide to make each bin. Unless the user
has studied the behaviour of residuals (particularly with regard to their
networks), we do not advise changing the default.
Type
| double |
Default
|
0.1
|
Minimum
| 0
(exclusive)
|
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts:
SUSPECT_BUMP_PERCENT
Description
If all of the measurements in network belong to Gaussian distribution (one of the typical assumptions in
least squares analysis) then the residual histogram should be strictly decreasing in the tail. There should
be only one local maxima near the median (a results of using equal distance bins instead of equal area). All
other local maxima are 'bumps' and reveal where the assumption of Gaussian noise is breaking down. The
SUSPECT_BUMP_PERCENT is the minimum bump height (in percentage of the preceding local minima) for a bump to be
considered suspect. And barring user override will be the boundary between inocent and suspect points.
Changing the default is not typically recomended.
Type
| double |
Default
|
5
|
Minimum
| 0
(inclusive)
|
Maximum
| 100
(inclusive)
|
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts:
GUILTY_BUMP_PERCENT
Description
If all of the measurements in network belong to Gaussian distribution (one of the typical assumptions in
least squares analysis) then the residual histogram should be strictly decreasing in the tail. There should
be only one local maxima near the median (a results of using equal distance bins instead of equal area). All
other local maxima are 'bumps' and reveal where the assumption of Gaussian noise is breaking down. The
GUILTY_BUMP_PERCENT is the minimum bump height (in percentage of the preceding local minima) for a bump to be
considered guilty. And barring user override will be the boundary between suspect and guilty points.
Changing the default is not typically recomended.
Type
| double |
Default
|
10
|
Minimum
| 0
(inclusive)
|
Maximum
| 100
(inclusive)
|
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts:
SUSPECT_FLOOR
Description
SUSPECT_FLOOR is the lowest that the boundary between inocent and suspect residual magnitudes will slip.
Histogram analysis may however result in a higher magnitude boundary.
Type
| double |
Default
|
1.0
|
Minimum
| 0.0
(inclusive)
|
Histogram Analysis Parameters--The user is advised to use caution if changing the defualts:
GUILTY_FLOOR
Description
GUILTY_FLOOR is the highest that the boundary between suspect and guilty residual magnitudes will slip.
Histogram analysis may however result in a lower magnitude boundary--strickly greater than the inocent-suspect boundary.
Type
| double |
Default
|
2.5
|
Minimum
| 0.0
(inclusive)
|
Measure Rejection Criteria:
HULL_REDUCTION_PERCENT
Description
Maximum precent reduction to the area of the convex hull of the measures in an image.
Type
| double |
Default
|
15
|
Minimum
| 0
(inclusive)
|
Maximum
| 100
(inclusive)
|
Measure Rejection Criteria:
MEASURE_REDUCTION_PERCENT
Description
Maximum precent reduction of the measures in an image.
Type
| double |
Default
|
30
|
Minimum
| 0
(inclusive)
|
Maximum
| 100
(inclusive)
|