model2point(1)                                                  model2point(1)



NAME
       model2point - converts model file to point file

SYNOPSIS
       model2point  [options]  model_file  point_file

DESCRIPTION
       Model2point will convert an IMOD or WIMP model file to a list of points
       with integer or floating point coordinates.  Each point will be written
       on a separate line, and the coordinates may be written either with no
       information about which object or contour the point came from, or with
       contour numbers, or with object numbers.

       Model2point and the companion program, Point2model, provide a more
       simple, but less versatile, way of converting data from and to an IMOD
       model than the Ascii format that can be output by Imodinfo.

OPTIONS
       Model2point uses the PIP package for input (see the manual page for
       pip).  The following options can be specified either as command line
       arguments (with the -) or one per line in a command file or parameter
       file (without the -).  Options can be abbreviated to unique letters;
       the currently valid abbreviations for short names are shown in paren-
       theses.


       -input (-i) OR -InputFile      File name
              Input model file.  If this option is not entered, the first non-
              option argument will be used for the input file.

       -output (-ou) OR -OutputFile   File name
              Output text file for points.  If this option is not entered, the
              second non-option argument will be used for the output file.

       -float (-fl) OR -FloatingPoint
              Output model coordinates as floating point; otherwise the near-
              est integer value is output.

       -scaled (-s) OR -ScaledCoordinates
              Output coordinates in model coordinate system, scaled by the
              pixel size and offset by origin values.  The default is to out-
              put index coordinates corresponding to the pixel coordinates in
              the image.

       -object (-ob) OR -ObjectAndContour
              Output object and contour numbers for each point (numbered from
              1)

       -contour (-c) OR -Contour
              Output contour number for each point (numbered from 1)

       -zero (-z) OR -NumberedFromZero
              Output object and contour numbers starting from 0 instead of 1

       -values (-v) OR -ValuesInLastColumn      Integer
              Enter 1 to output general point values as the last number on
              each line, after the Z coordinate, or -1 to output general con-
              tour values for the first point in each contour.  A point file
              with either format can be read back in by Point2model, pro-
              vided that the -values option is given to that program.  When a
              point or contour has no stored value, a value of 0 will be out-
              put, unless a different value is specified with the -fill
              option.

       -fill (-fi) OR -FillValue      Floating point
              Value to output when contour/point has no stored value (default
              0)

       -help (-h) OR -usage
              Print help output.

       -StandardInput
              Read parameter entries from standard input.


HISTORY
       Written by David Mastronarde, 4/23/95
       Converted to PIP, added output options

BUGS
       Email bug reports to mast at colorado dot edu.



BL3DEMC                              4.7.3                      model2point(1)