Help for AUTOMATCH
PURPOSE
AUTOMATCH is a program which automatically acquires tiepoints from
sets of images for the purpose of producing mosaics.
To obtain a more global view of the entire mosaicking process
you should look at the procedures in r3lib called:
MANUAL2.COM for Voyager, and MANUAL4.COM for Galileo.
AUTOMATCH replaces MANMATCH in these procedures.
Automatch is designed to generate tiepoints from sets of images which
have been generated in a "burst" of frames where the scale & rotation
do not differ much between images. Provision is built into
the program to compensate for differences between images by projecting
the correlation areas before correlation. This is limited however
to scale ranges of at most 2:1 and modest rotations which will
not confuse the overlap area algorithm. Automatch will NOT
work well on cases containing the limb.
EXECUTION
For VGR:
AUTOMATCH inp=(sedr.int,over.int,geoma.cor) out=match.int project=VGR-1 filename=LISTOFFILES
For GLL:
automatch inp=(jupsedr.int,jupover.int) out=jupmatch.int filename=LISTOFFILES project=GLL
USAGE:
AUTOMATCH is an batch program which has in the SEDR.INT file
the FDS or SCET times of all of the frames to inspect along
with all the navigation for these images..
You must create this file using the program IBISNAV
AUTOMATCH can obtain the names (and thus the locations) of all the
input files in one of two ways:
(recommended)
1. By the user specifying the parameter FILENAME which points to
a file created by a text editor and which contains the full
file names of each input picture in the order of priority, one
name per record. This is the same file used in IBISNAV.
So, if the first 2 pictures are called scx1:[jjl059]1234567.img
and mipldisk:[mipl.gll]venus.img the first two records of
FILENAME would contain:
scx1:[jjl059]1234567.img
mipldisk:[mipl.gll]venus.img
(obsolete)
2. By building each file name by appending to the DIR keyword
the integer contained in column 1 of the SEDR.INT file followed
by .IMG. You must in this mode name the input pictures
accordingly.
For Voyager, column 1 is the FDS times thus the frames must be
named the same as their FDS times; ie: 7654321.img is the file
name of the image with fds time 7654321.
For Galileo the FDS times are just 1,2,3,4.. so the file names are
1.img 2.img etc.
So, if DIR=scx1:[jjl059] and SEDR.INT has fds time 1234567 in column
one then the built-up name would be: scx1:[jjl059]1234567.img
The second input file
contains the overlap frame pairs to present to the user.
This file is created by program MOSPLOT.
First input= SEDR.INT produced by program IBISNAV
Second input= OVER.INT produced by program MOSPLOT
Automatch will perform the following steps:
For each overlap pair:
1. Compute the overlap area in the right image by projecting the
4 corners of the left image into the right image using the SEDR.
2. Select the correlation size to fit in the overlap area.
3. Select a row or column (whichever is the longest) through the
overlap area and select a number of candidate tiepoint locations
in the right image.
4. Compute the corresponding tiepoint positions in the left image
using the SEDR.
5. Perform correlations.
6. Fit a 1st order polynomial to the tiepoints.
7. Iteratively reject all points (one at a time) exceeding a threshold
pixel tolerance.
8. Select the 2 remaining points the furthest apart.
9. Place these in the output.
NOTE:
The output file is the same as the file written by MANMATCH. So
if AUTOMATCH cannot process a certain number of overlap pairs you
can input the AUTOMATCH output into MANMATCH as the last input file
and go to the pairs in question to acquire points manually.
Be sure to inspect footprint plots of your mosaic generated by
MOSPLOT and to edit the overlap file with EDIBIS to delete
extraneous & redundant overlaps to save time and later confusion.
At the moment automatch can accept up to 256 image pairs.
FILE STRUCTURE:
The tiepoints file is an IBIS format tabular file. It consists
of 512 byte records where each column of data is written as
sequential records until exhausted. The next column begins at the
start of the next record etc. Record #1 contains the number of points
per column. All data is real*4 binary.
PARAMETERS:
INP
All inputs are IBIS tabular files.
First input= SEDR.INT produced
by program IBISNAV
Second input= OVER.INT produced
by program MOSPLOT
Third input=geoma parameters
(optional).
OUT
The output IBIS tabular file.
nine columns output:
col1=first frame number of a pair
col2=second frame number of a pair
col3=first frame tiepoint line
col4=first frame tiepoint sample
col5=second frame tiepoint line
col6=second frame tiepoint sample
col7=1
col8=1
col9=1
PROJECT
Batch parameter !
Specifies the
project.
CAMERA
Camera serial no.
OBJECT
Causes images to be
considered geometrically
corrected.
PFILTER
The power of the FFT high pass
power law filter. Default
is no power filter.
default is: pfilter=0.0 real
PHASE
Degree of phase correlation:
0 for normal correlation. ( Default ).
1 for phase correlation
OFFMAX
How far off center, correlation
peak is allowed (0 to 1).
If the peak is more than
OFFMAX*window/2 pixels from
the center it is rejected.
Default is 0.8
FUNC
Pixel function before
correlation is performed..
The options are: LOG or EXP.
DEfault is no funtion performed.
REDO
Keyword for redo mode.
Valid responses are:
REDO or NOREDO.
The default is REDO.
Redo specifies that if
the first correlation for
an area has an offset of
less than the OFFMAX limit
but greater than zero
the correlation is rerun
beginning at the new location.
NTPTS
The number of
tiepoints to collect
per pair.
TOLERANC
The largest
permitted tiepoint
residual.
PRINT
'NOPRINT to turn off
terminal output
DIR
Specifies the directory
name where all the
input files for the
mosaic reside.
(obsolete)
FILENAME
Specifies a file name
which contains the
names of all the
images to be included
in the mosaic
NOPRINT
To suppress printout
about each tiepoint
displayed at the terminal
CORR
Specifies the correlation size.
Is not supported now.
SUBPIX
Specifies sub-pixel correlation.
Not tested or supported.
!NOSEDR option currently not supported for testing.
!.VARIABLE NOSEDR
!Limits reading of the
!navigation file.
!Is not supported now.
See Examples:
Cognizant Programmer: