DATAMANIP (kdatamanip) functions


LIBRARY ROUTINE

lkelevation - use plane of value data to construct elevation

LIBRARY CALL

int lkelevation(
   kobject src_obj,
   double  xbegin,
   double  ybegin,
   double  xend,
   double  yend,
   int     dpos,
   int     tpos,
   int     epos,
   char   *datatype_string,
   kobject dst_obj)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

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.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

Destination object must not already contain location data.

MODIFICATION

none

FILES

$DATAMANIP/objects/library/kdatamanip/src/lkelevation.c

SEE ALSO

kdatamanip(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.