DATAMANIP commands
PROGRAM NAME
kelevation - Create Elevation Location Data From Value Plane
DESCRIPTION
This routine will create explicit curvilinear location
data containing a plane of elevation data.
The generated location data will consist of a single
width-height plane of location data, with a dimension
size of three, for storing (x,y,z) values. The (x,y)
values are generated across a uniform range according
to the specified (xbegin - xend) and (ybegin - yend)
ranges. The z-values will be filled out with a
single plane of data extracted from the value segment
of a provided input object. The depth, time, and
element position in the value segment of the plane to
be used for z-values can also be specified.
The width and height of the value segment in the
provided input object will dictate the width and
height of the resulting location segment. The
datatype of the resulting location segment can either
be propagated from the input value segment, or can be
specified explicitly. If set explicitly, the data
will be cast to this type as it is retrieved from the
value segment.
The (x,y) data is generated and stored as one block,
so generating large elevation data sets is subject to
the memory limitations of your machine.
REQUIRED ARGUMENTS
- -i
-
type: infile
desc: Input value data object to use for elevation
- -o
-
type: outfile
desc: Resulting Output Object with elevation
OPTIONAL ARGUMENTS
- -xbegin
-
type: double
desc: Explicit Location Begin for X dimension
default: 0
bounds: no range checking
- -xend
-
type: double
desc: Explicit Location End for X dimension
default: 1
bounds: no range checking
- -ybegin
-
type: double
desc: Explicit Location Begin for Y dimension
default: 0
bounds: no range checking
- -yend
-
type: double
desc: Explicit Location End for Y dimension
default: 1
bounds: no range checking
- -doff
-
type: integer
desc: Depth of Value Plane to transfer
default: 0
bounds: value >= 0
- -toff
-
type: integer
desc: Time of Value Plane to transfer
default: 0
bounds: value >= 0
- -eoff
-
type: integer
desc: Element of Value Plane to transfer
default: 0
bounds: value >= 0
- -type
-
type: list
desc: Resulting Elevation will be in data type
default: 0 "Propagate Value Type"
EXAMPLES
SEE ALSO
kgenloc
RESTRICTIONS
The data is generated and stored as one block, so generating large
location data sets are subject to the memory limitations of your
machine.
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.