squeezevol(1)                                                    squeezevol(1)



NAME
       squeezevol - Reduce or expand a volume in all dimensions by interpola-
       tion.

SYNOPSIS
       squeezevol [options] <input file>  <output file>

DESCRIPTION
       squeezevol provides a command-line interface to the program matchvol,
       for reducing (or expanding) an image volume in size in all dimensions
       by 3-D interpolation.  There are options for specifying the overall
       scaling factor, independent scaling factors for each dimension, and the
       extent of the input volume to be scaled.  The size of the output volume
       is automatically set to the appropriate size to contain the scaled
       input volume.  There is a default global scaling factor, which can be
       changed with either -f or -e The factors are referred to as "squeezing"
       factors because the volume is actually scaled by the inverse of each
       factor.  When you enter and expansion factor instead, the volume is
       expanded by that factor.

       Pixel size and origin values in the header of the output file are set
       so that the coordinate system matches that of the input file.  Thus,
       models drawn on the input file in 3dmod should load correctly onto the
       output file, and vice versa.

   Options
       Squeezevol 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 -):

       -f OR -factor   Floating point
              Global factor to squeeze by, default = 1.6

       -e OR -expand   Floating point
              global expansion factor

       -x OR -xFactor       Floating point
              Factor to squeeze in X dimension, default is global factor or
              1/expansion

       -y OR -yFactor       Floating point
              Factor to squeeze in Y dimension, default is global factor or
              1/expansion

       -z OR -zFactor       Floating point
              Factor to squeeze in Z dimension, default is global factor or
              1/expansion

       -ix OR -ixSize       Integer
              Input size in X dimension, default is full X size of volume

       -iy OR -iySize       Integer
              input size in Y dimension, default is full Y size of volume

       -iz OR -izSize       Integer
              input size in Z dimension, default is full Z size of volume

       -t OR -tempdir       File name
              Directory to use for temporary files

       -l OR -linear
              Use linear interpolation; default is quadratic

       -StandardInput
              Read parameter entries from standard input


FILES
       If the output file already exists a backup image of the original is
       created with the ~ extension.

AUTHOR
       David Mastronarde  <mast at colorado dot edu>

SEE ALSO
       matchvol



BL3DEMC                              4.5.6                       squeezevol(1)