xfinterstack(1)             General Commands Manual            xfinterstack(1)



NAME
       xfinterstack - transform a model to match model built on other stack

SYNOPSIS
       xfinterstack

DESCRIPTION
       This program will transform a model that has been built on one data
       stack so that it will match the coordinates of a different data stack
       that has some sections overlapping the first stack.

       To use it, you must first build a model file in which each object has
       two points: the first point placed on a point in the first data stack,
       the second point placed on the exactly corresponding point on the same
       section in the second data stack.  This does not require very many
       objects - 10 should be plenty.

       Entries to the program are:

       Name of the model file containing the objects with corresponding points
       on an overlapping section.

       The Z value (typically the section #) for the points on the section in
       the first data stack.  Only model objects whose first point has this Z
       value will be included

       1 for a full report of deviations of points from perfect correspondence
       (see below)

       (After the program solves for a transformation):
       Name of the model file to be transformed

       0 to transform model from fitting the first stack to fitting the second
       stack, or 1 to transform it from fitting the second stack to fitting
       the first stack.

       If the second point in each correspondence object has a different Z
       value from the first point (i.e. if the two data stacks do not have
       congruent Z coordinates), then the Z values of all points in the model
       being transformed will be adjusted by the difference in Z's of the cor-
       respondence points.

       When the program solves for the transformation between a pair of sec-
       tions, it applies the transformation to the points on the second sec-
       tion of the pair, and computes the displacement, or deviation, between
       each point and the corresponding point on the first section of the
       pair.  It then reports the mean deviation for all of the points, the
       maximum deviation, and the object number of the point with maximum
       deviation.  In addition, you may elect to have a complete report of the
       deviations of all points for particularly bad sections.  If you choose
       this option, you control which sections are reported by specifying cri-
       terion values for the mean and maximum deviations; the full report will
       be made for any sections with mean or maximum deviations greater than
       the respective criteria.

HISTORY
       Written by David Mastronarde, 1/4/90

BUGS
       Email bug reports to mast at colorado dot edu.



IMOD                                4.12.61                    xfinterstack(1)