imod-dist(1)                                                      imod-dist(1)



NAME
       imod-dist - distance measurement tool for IMOD model files

SYNOPSIS
       imod-dist [options] -r ref_object -c|-p ref_point  -m list  input_model

DESCRIPTION
       imod-dist computes the distance between a reference location and other
       points in an IMOD model.  The reference object can be either a single
       point in a IMOD object or the centroid of the object.  The euclidean
       distance is reported for all points in the object list specified.

       Since a reference for the measurements must be a unique point, either a
       point within the reference object or the centroid of the object must be
       specified.


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

       -i OR -InputModel    File name
              The IMOD model file to analyze.  If this option is not entered,
              the first non-option argument will be used for the input file
              name.  One way or another, the option is required.

       -o OR -OutputFile    File name
              A file to write the results into.  If this option is not entered
              and there is a second non-option argument, it will used as an
              output file name.  If no output file is defined, results will be
              printed to standard out.

       -c OR -CentroidReference
              Reference all measurements to the centroid of the specified ref-
              erence object

       -l OR -ContourReference   Integer
              The index of the contour to use when specifying a point in the
              reference object (default: 0).

       -m OR -Measure       List of integer ranges
              The list of objects to measure.

       -p OR -PointReference     Integer
              Reference all measurements to this point in specified contour in
              the specified reference object.

       -r OR -ReferenceObject    Integer
              The object to use for referencing all distance measurements

       -v OR -verbose
              Print out information about the objects and models being pro-
              cessed

       -V OR -VeryVerbose
              Print out lots of debugging information

       -h OR -usage
              Print help output

       -StandardInput
              Read parameter entries from standard input


AUTHOR
       Rick Gaudette

BUGS
       Email bug reports to mast at colorado dot edu.




BL3DEMC                              4.7.3                        imod-dist(1)