GEOMETRY commands


PROGRAM NAME

kslicer - Extract (N-1)D Region from (N)D Object

DESCRIPTION

This routine will generate an (N-1)D data set from an N-D data set. This is done by selecting a plane to slice along and a slice number into that plane. Planes are specified as being orthogonal to either the width, height, depth, time, or element dimenstions of the input data object. The slice plane can either be specified as a specific plane number, or a percentage depth into the data along the specified slice plane. The user also has the option of reorienting the slice to be aligned with the width-height plane. This will make it suitable for direct viewing with any of the image viewing programs. If the original data set contains no location data, then explicit corner markers may be added to position the data in space.

REQUIRED ARGUMENTS

-i
type: infile
desc: input file to slice
-o
type: outfile
desc: output file containing slice

OPTIONAL ARGUMENTS

-p
type: integer toggle
desc: choose orthogonal slice plane
default: 1
allowed values:
-reo
type: flag
desc: reorient slice to face image plane
-loc
type: flag
desc: force explicit location data

Mutually Exclusive Group; if desired, specify ONE of:

-ps
type: float
desc: slice at percentage depth on slice plane
default: 0.5
bounds: 0 < [-ps] < 1
OR
-s
type: float
desc: slice at position on slice plane
default: 0
bounds: value >= 0.0

EXAMPLES

kslicer -i volume:ytterbium -o sliced.ytterbium -reo -p 2 -ps 0.4 
will slice the ytterbium volume along height at a plane that is 40% deep
into the height dimension.  The resulting plane will be reoriented to
face the width-height plane.

SEE ALSO

RESTRICTIONS

Rectilinear data will not be presereved when slicing. When slicing data with uniform location data, the reorientation feature will be ignored.

REFERENCES

COPYRIGHT

Copyright (C) 1996,1997 , The Regents of the University of California. All rights reserved.