NAME

       teem-unu - Utah Nrrd Utilities command-line interface

DESCRIPTION

       "teem-unu" is a command-line interface to much of the functionality in "nrrd",

              a  C  library  for  raster  data  processing.  Nrrd  is  one  library in the "Teem"
              collection of libraries. More information about Teem is at <http://teem.sf.net>.

              Users are strongly encouraged to join the teem-users mailing list:

              <http://lists.sourceforge.net/lists/listinfo/teem-users>. This is the primary forum
              for feedback, questions, and feature requests.

              The utility of unu is mainly as a pre-processing tool for getting data

              into  a type, encoding, format, or dimensions best suited for some visualization or
              rendering task. Also, slices and projections are effective ways to visually inspect
              the contents of a dataset. Especially useful commands include make, resample, crop,
              slice, project, histo, dhisto, quantize, and  save.  Full  documentation  for  each
              command  is shown by typing the command alone, e.g., "unu make". Unu can process CT
              and MRI volume datasets, grayscale and color images, time-varying volumes of vector
              fields  (5-D  arrays),  and  more. Currently supported formats are plain text files
              (2-D float arrays), NRRD, VTK structured points, and PNG and PNM images. "unu  make
              -bs  -1"  can  read from DICOM files. "unu save" can generate EPS files.  Supported
              encodings are raw, ascii, hex, gzip, and bzip2.

              Much of the functionality of unu derives from chaining multiple

              invocations together with pipes ("|"), minimizing the need to save out intermediate
              files.  For  example,  if  "data.raw.gz"  is a gzip'ed 256 x 256 x 80 volume of raw
              floats written from a PC, then the following will save to  "zsum.png"  a  histogram
              equalized summation projection along the slowest axis:

              unu make -i data.raw.gz -t float -s 256 256 80 -e gzip -en little \

              |  unu  project  -a  2  -m  sum  \  | unu heq -b 2000 -s 1 \ | unu quantize -b 8 -o
              zsum.png

              If unu or nrrd repeatedly proves itself useful for your research, an

              acknowledgment to that effect in your publication  would  be  greatly  appreciated,
              such  as (for LaTeX): "Dataset processing performed with the {\tt unu} tool (or the
              {\tt  nrrd}  library),  part  of  the  {\tt  Teem}  toolkit   available   at   {\tt
              $<$http://teem.sf.net$>$}"

              Formats  available:  nrrd  pnm  png vtk text eps Nrrd data encodings available: raw
              ascii hex gz bz2

SEE ALSO

       The full documentation for teem-unu is maintained as a Texinfo manual.  If  the  info  and
       teem-unu programs are properly installed at your site, the command

              info teem-unu

       should give you access to the complete manual.