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