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.