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.