automat Documentation

automat - Finds overlap points of images
This program will find the overlap points of a mosaicked
set of images for matchpoint finding. The FROM image is
created by first taking all the images in a set that need
matchpoints and setting the valid pixel values to a DN of
1. Then all the images are mosaicked together using the
ADD option in the mosaic program. This will create a single
image that has a DN of 1 where no images overlap, a DN of
2 where 2 images overlap, a DN of 3 where 3 images overlap,
etc. This program reads the FROM image into memory and scans
it from top to bottom. Whenever it encounters a pixel with
a DN other than 1, then it records the line, sample, and
DN number in the TO file. The program will then fill in the
polygon that contains the DN value with zeroes, keeping
track of the number of pixels in the polygonal area and the
min/max line and sample for the area. The pixel count and
the min/max line,sample for the area are also recorded in
the TO file. The user can use this information to determine
if the area is valid for picking matchpoints. An area needs
to be more than 2 pixels wide in sample and line dimensions
to be valid. There is also a minimum number of pixels that
an area must contain before it can be valid for matchpoint
picking.

Programmer: Janet Barrett, U.S.G.S., Flagstaff, AZ

Input cube file name
  (default extension is .cub)

NONE

Output text file name

NONE

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed. This file is created by first taking all the images in a set that need matchpoints and setting the valid pixel values to a DN of 1. Then all the images are mosaicked together using the ADD option in the mosaic program. This will create a single image that has a DN of 1 where no images overlap, a DN of 2 where 2 images overlap, a DN of 3 where 3 images overlap, etc. This should be a single band file. If there is more than 1 band in this file, all bands except the first one will be ignored.
TO	Output text file name. For each overlap point found in FROM, this file will have a record containing the line, sample, DN of the point, the number of pixels in the overlap area, and the min/max line and sample of the overlap area. If the TO file does not exist, it will be created. If the TO file does exist, then automat will append the output to it.