teem-unu(1)							   User Commands						       teem-unu(1)

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 sum-
	      mation 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 {	t unu} tool (or the {	t nrrd} library), part of the {	t Teem} toolkit available at {	t $<$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.

1.10.0								 December 10, 2008						       teem-unu(1)