DATAMANIP commands


PROGRAM NAME

kexp - Compute Exponential (antilog)

DESCRIPTION

The Exponential operator, kexp, computes the exponential of an object element by element. If the object has an associated mask, the operation will be gated so that the exponential is computed only on valid elements, indicated by non-zero mask values. A zero mask value will cause the value of the corresponding element in the input object to be transferred the output object.

The exponential of the base value is the base raised to the value of the object element. For example, b10(x) = 10**x. Three standard-base exponentials are provided, and alternate bases can be specified using the -base option. be returns the natural exponential of x (e**x), and b2 and b10 return 2**x and 10**x respectively.

If the -offset option is set to TRUE, the value returned will be the result of the exponential operation minus 1 (exp(result) - 1). SPECIAL NOTE: The exponential() has machine-specific characteristics! To fix this, an error message is returned if the user specified base is less than or equal to zero.

If the input object has a map, then kexp will operate on the map, leaving the value data untouched.

REQUIRED ARGUMENTS

-i
type: infile
desc: input data object
-o
type: outfile
desc: resulting output data object

Mutually Exclusive Group; you must specify ONE of:

-be
type: flag
desc: Compute exponential using natural base 2.71828...
OR
-b10
type: flag
desc: Compute exponential using base 10
OR
-b2
type: flag
desc: Compute exponential using base 2
OR
-base
type: double
desc: User Specified base
default: 2
bounds: no range checking

OPTIONAL ARGUMENTS

-offset
type: boolean
desc: Return either result [False] or result-1 [True]
default: true

EXAMPLES

SEE ALSO

DATAMANIP::klogexp

RESTRICTIONS

REFERENCES

COPYRIGHT

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