teem-unu(1) [debian man page]
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)
Check Out this Related Man Page
teem-mrender(1) User Commands teem-mrender(1) NAME
teem-mrender - A demonstration of hoover, gage, and nrrd measures. SYNOPSIS
teem-mrender [@file ...] -i <nin> -k <kind> -fr <eye pos> [-at <at pos>] [-up <up dir>] [-rh] [-or] -dn <near> -di <image> -df <far> [-ar] [-ur <uMin uMax>] [-vr <vMin vMax>] [-fv <field of view>] [-offfr] [-turn <angle>] [-is <image size>] [-k00 <kernel>] [-k11 <kernel>] [-k22 <kernel>] [-rn] -q <query> -m <measure> [-gmc <min gradmag>] [-fn <from nan>] [-step <size>] [-nt <# threads>] [-vp <img coords>] [-o <filename>] @file ... = response file(s) containing command-line arguments -i <nin> = input nrrd to render (nrrd) -k <kind> = "kind" of volume ("scalar", "vector", or "tensor") (kind) -fr <eye pos> = camera eye point (3 doubles) -at <at pos> = camera look-at point (3 doubles); default: "0 0 0" -up <up dir> = camera pseudo-up vector (3 doubles); default: "0 0 1" -rh = use a right-handed UVN frame (V points down) -or = orthogonal (not perspective) projection -dn <near> = distance to near clipping plane (double) -di <image> = distance to image plane (double) -df <far> = distance to far clipping plane (double) -ar = near, image, and far plane distances are relative to the *at* point, instead of the eye point -ur <uMin uMax> = range in U direction of image plane (2 doubles); default: "nan nan" -vr <vMin vMax> = range in V direction of image plane (2 doubles); default: "nan nan" -fv <field of view> = angle (in degrees) vertically subtended by view window (double); default: "20" -offfr = the given eye point ("-fr") is to be interpreted as an offset from the at point. -turn <angle> = angle (degrees) by which to rotate the from point around true up, for making stereo pairs. Positive means move towards positive U (the right) (double); default: "0.0" -is <image size> = image dimensions (2 ints); default: "256 256" -k00 <kernel> = value reconstruction kernel (kernel specification); default: "tent" -k11 <kernel> = first derivative kernel (kernel specification); default: "cubicd:1,0" -k22 <kernel> = second derivative kernel (kernel specification); default: "cubicdd:1,0" -rn = renormalize kernel weights at each new sample location. "Accurate" kernels don't need this; doing it always makes things go slower -q <query> = the quantity (scalar, vector, or matrix) to learn by probing (string) -m <measure> = how to collapse list of ray samples into one scalar. Possibilities includeo "min", "max", "mean", "median", "mode", "variance", "skew" (self-explanatory)o "intc", "slope", "error": intercept, slope, and error from line fittino "sd": standard deviatioo "product", "sum": product or sum of all valueo "L1", "L2", "Linf": different normso "histo-min", "histo-max", "histo-mean", "histo-median", "histo-mode", "histo-product", "histo-l2", "histo-sum", "histo-variance", "histo-sd": same measures, but for situations where we're given not the original values, but a his- togram of them. (measure) -gmc <min gradmag> = For curvature-related queries, set answer to zero when gradient magnitude is below this (double); default: "0.0" -fn <from nan> = When histo-based measures generate NaN answers, the value that should be substituted for NaN. (double); default: "nan" -step <size> = step size along ray in world space (double); default: "0.01" -nt <# threads> = number of threads hoover should use (int); default: "1" -vp <img coords> = pixel coordinates for which to turn on all verbose debugging messages, or "-1 -1" to disable this. (2 ints); default: "-1 -1" -o <filename> = file to write output nrrd to. Defaults to stdout ("-"). (string); default: "-" DESCRIPTION
Uses hoover to cast rays through a volume (scalar, vector, or tensor), gage to measure one of various quantities along the rays, and a specified nrrd measure to reduce all the values along a ray down to one scalar, which is saved in the output (double) image. SEE ALSO
The full documentation for teem-mrender is maintained as a Texinfo manual. If the info and teem-mrender programs are properly installed at your site, the command info teem-mrender should give you access to the complete manual. 1.10.0 December 10, 2008 teem-mrender(1)