unu - Man Page

unu COMMAND [OPTION]...

unu(1) 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. A checkout of Teem source is available via:

svn co https://svn.code.sf.net/p/teem/code/teem/trunk teem

Long-term maintenance of this software depends on funding, and funding depends on being able to document who is using it for what. If unu(1) or Nrrd has helped in your research, including for simple one-off experiments or mundane data hacking, the developers of Teem would love to know. There are multiple ways of communicating this. In your publications, consider adding a line such as this in the Acknowledgments: Data processing performed with the unu tool, part of the Teem toolkit available at http://teem.sf.net. Alternatively, please email glk@uchicago.edu and briefly describe how Teem software has helped in your work. Please also consider joining the teem-users mailing list. This is the primary forum for feedback, questions, and feature requests.

A summary list of unu commands is generated by running simply “unu”. Running a unu(1) command without additional arguments (e.g. “unu slice”) generates its description and usage information. This includes information (marked with “* Uses ...”) about the underling Nrrd library calls (e.g. nrrdSlice()) that implement the basic functionality in that unu(1) command.

The utility of unu(1) 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. unu(1) 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 most DICOM files. “unu save” can generate EPS files. Supported encodings are raw, ascii, hex, gzip, and bzip2.

Much of the functionality of unu(1) 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

Formats available: nrrd pnm png vtk text eps

Nrrd data encodings available: raw ascii hex gz bz2

Each of the following has a corresponding man page: for example, unu-about(1) for “unu about”.

See unu-env(1).

gprobe(1), ilk(1), mrender(1), miter(1), nrrdSanity(1), overrgb(1), puller(1), tend(1), vprobe(1), unu-1op(1), unu-2op(1), unu-3op(1), unu-about(1), unu-acrop(1), unu-affine(1), unu-axdelete(1), unu-axinfo(1), unu-axinsert(1), unu-axmerge(1), unu-axsplit(1), unu-ccadj(1), unu-ccfind(1), unu-ccmerge(1), unu-ccsettle(1), unu-cksum(1), unu-cmedian(1), unu-convert(1), unu-crop(1), unu-data(1), unu-dhisto(1), unu-dice(1), unu-diff(1), unu-dist(1), unu-env(1), unu-fft(1), unu-flip(1), unu-gamma(1), unu-head(1), unu-heq(1), unu-histax(1), unu-histo(1), unu-i2w(1), unu-imap(1), unu-inset(1), unu-jhisto(1), unu-join(1), unu-lut(1), unu-lut2(1), unu-make(1), unu-minmax(1), unu-mlut(1), unu-mrmap(1), unu-pad(1), unu-permute(1), unu-project(1), unu-quantize(1), unu-resample(1), unu-reshape(1), unu-rmap(1), unu-save(1), unu-shuffle(1), unu-slice(1), unu-splice(1), unu-sselect(1), unu-subst(1), unu-swap(1), unu-tile(1), unu-unorient(1), unu-unquantize(1), unu-untile(1), unu-w2i(1)

gprobe(1), ilk(1), miter(1), mrender(1), nrrdSanity(1), overrgb(1), puller(1), tend(1), unu-1op(1), unu-2op(1), unu-3op(1), unu-about(1), unu-acrop(1), unu-affine(1), unu-axdelete(1), unu-axinfo(1), unu-axinsert(1), unu-axmerge(1), unu-axsplit(1), unu-ccadj(1), unu-ccfind(1), unu-ccmerge(1), unu-ccsettle(1), unu-cksum(1), unu-cmedian(1), unu-convert(1), unu-crop(1), unu-data(1), unu-dhisto(1), unu-dice(1), unu-diff(1), unu-dist(1), unu-env(1), unu-fft(1), unu-flip(1), unu-gamma(1), unu-head(1), unu-heq(1), unu-histax(1), unu-histo(1), unu-i2w(1), unu-imap(1), unu-inset(1), unu-jhisto(1), unu-join(1), unu-lut(1), unu-lut2(1), unu-make(1), unu-minmax(1), unu-mlut(1), unu-mrmap(1), unu-pad(1), unu-permute(1), unu-project(1), unu-quantize(1), unu-resample(1), unu-reshape(1), unu-rmap(1), unu-save(1), unu-shuffle(1), unu-slice(1), unu-splice(1), unu-sselect(1), unu-subst(1), unu-swap(1), unu-tile(1), unu-unorient(1), unu-unquantize(1), unu-untile(1), unu-w2i(1), vprobe(1).