DATAMANIP commands
PROGRAM NAME
kexpand - Expand Object Via Pixel Replication
DESCRIPTION
The Expand Object operator (kexpand) increases the size of the Input data
object (i) using pixel replication. Magnification factors for each dimension,
Width (wmag), Height (hmag) Depth (dmag), Time (tmag), and Elements (emag)
can be specified.
Magnification factors greater than one will increase the object size. (Factor
values less than 1 but greater than zero are also valid, and will reduce the
size of the object.)
The resultant output object size will be the original size multiplied
by the magnification factor for that dimension, and rounded.
Pixel replication is done on a floating point indexing basis, where the
data point index is obtained by truncating the cumulative floating point
index. Therefore, when the calculated replication factor is non-integer,
the resulting integer step size varies during the process.
Data Type
The data type of the output object is the same as the input object's data
type. Internally, the data is processed using one of the following: unsigned
byte, long, unsigned long, double, or double complex. Data will not be cast
to a lower type for processing.
If there is map and value data in the source object, the map is transferred
to the destination object.
Failure Modes
This program fails if the input object lacks both map data and value data.
If explicit location or time data are available, the sampling algorithm
can not resample these data yet, and will fail. This will be implemented
later ....
Executing Expand Object runs the program kresample with
-resize set to true and -inter set to 0.
REQUIRED ARGUMENTS
- -i
-
type: infile
desc: Input object
- -o
-
type: outfile
desc: Resulting subsampled object
OPTIONAL ARGUMENTS
- -wmag
-
type: double
desc: Magnification factor in width dimension
default: 2
bounds: value > 0.0
- -hmag
-
type: double
desc: Magnification factor in height dimension
default: 2
bounds: value > 0.0
- -dmag
-
type: double
desc: Magnification factor in depth dimension
default: 1
bounds: value > 0.0
- -tmag
-
type: double
desc: Magnification factor in time dimension
default: 1
bounds: value > 0.0
- -emag
-
type: double
desc: Magnification factor in elements dimension
default: 1
bounds: value > 0.0
EXAMPLES
SEE ALSO
DATAMANIP::kresample, DATAMANIP::kshrink
RESTRICTIONS
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.