squeezevol(1)               General Commands Manual              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.  However, it will use Binvol to
       reduce with antialias filtering instead whenever possible, because this
       method should produce a less noisy result than 3-D interpolation, espe-
       cially for larger reduction factors.  There are options for specifying
       the overall scaling factor, independent scaling factors for each dimen-
       sion, 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 an expansion factor instead,
       the volume is expanded by that factor.

       Binvol is used if there is no expansion and the reductions in X and
       Y are either the same or have integer values.  This behavior can be
       overridden with the -legacy option.

       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 -).
       Options can be abbreviated to unique letters; the currently valid
       abbreviations for short names are shown in parentheses.

       -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 by which to squeeze in the X dimension.  When doing
              expansion, this must be the inverse of the desired expansion
              factor.  The default is the global squeezing factor or the
              inverse of the global expansion factor.

       -y OR -yFactor       Floating point
              Factor by which to squeeze in the Y dimension.  The default is
              the global squeezing factor or 1/expansion factor.

       -z OR -zFactor       Floating point
              Factor by which to squeeze in the Y dimension.  The default is
              the global squeezing factor or 1/expansion factor.

       -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

       -legacy (-le) OR -LegacyInterpolation
              Use 3-D interpolation in Matchvol instead of Binvol

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

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

       -PID   Print process ID

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

       -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, Binvol



IMOD                                4.12.61                      squeezevol(1)