tprint Documentation

tprint - List information from the "tfile"
The main purpose of this program is a debugging tool.  The TFILE is
created by several programs that are drivers for GEOM, such as PLANSINU
and NUPROJ.  The TFILE is an unformatted ascii file that can not be
examined by an editor. TPRINT reads the TFILE and writes it into the
session log file.  The TFILE contains arrays of line, sample positions
on the inupt cube in a grid pattern of 64 x 64 pixel blocks.  The
intersections of these grid lines defines a pixel location on the
output cube.  This must be tied to a point on the input cube.

There are many different things which can be interpreted from a listing
of this file.  The approximate shape of the cube area can be plotted by
drawing a line around all valid input pixels.  If either a line or
sample number is larger than the total number for the input cube, or if
it is a negative value then it is a non-valid or null pixel.  This means
that on the cube after it has been geomed there will be no cube data
there. For instance if a rectangular cube was rotated 45 degrees, it
would look diamond shaped and the corners would look cut off. The cut
off corners are null pixels.

If the cube area looks extremely small compared to the size of the
whole output file, or only a small area of the input cube is used in
the tfile.dat then the scale of the cube may be wrong.

The cube may look like one side of it has been cut off, which may be
incorrect boundaries.

The cube may look very distorted in shape, which could be anything, but
most likely results from inaccurate control points.

NOTE:  PHOTOMPR also creates a tfile that can be read by PHOTOM, but
the output of PHOTOMPR is arrays of mult and add values instead of line
sample positions.

PROGRAMMER: Kay Edwards, U.S.G.S. Flagstaff, Az

Transformation file name
(No default extension)

tfile.dat

List block summary information
(YES,NO)

NO

List the block containing the
given line and sample
(YES,NO)

YES

Approximate line number

1

Approximate sample number

1

ADDITIONAL NOTES:

Parm	Description
TFILE	This is the file to be used by GEOM to transform the cube. It is generated by one of the projection driver programs, such as NUPROJ, RANDOM, PLANSINU, NOPROJ, etc.
SUMMARY	When SUMMARY=YES, number of rows, number of columns, row spacing, and column spacing is listed for each block in the TFILE.
GRID	When GRID=YES, the line and sample values for a 64x64 pixel block will be listed. The line and sample parameters are used to determine which block to list.
LINE	TPRINT will calculate which 64x64 block contains the line and sample entered and list all the line, sample values in that block when GRID=YES.
SAMPLE	TPRINT will calculate which 64x64 block contains the line and sample entered and list all the line, sample values in that block when GRID=YES.