DATAMANIP commands


PROGRAM NAME

kbessel - Compute Bessel Functions

DESCRIPTION

The Bessel function returns the Bessel function of the specified kind and order for each data point in the input data object, Input. The data type of the output data object, Output, will always be the same as the data type of Input.

All processing is done in double precision float. If the input data is complex, only the real component of the data is processed.

Map Data The Bessel function operator has not been written to be fully polymorphic yet. It does not check for map data, and will therefore always operate on the value data, even if a map exists. This will most likely corrupt indexing ' into the map. It is recommended to use the Copy to Value (kcptoval) segment operator to temporarily move the map data into the value segment, run the Bessel operator on the data, then move it back to the map with the Copy from Value (kcpfromval) operator.

Validity Mask If there is a validity mask associated with the input object, the mask is transferred to the output object. To decrease processing time, the operation will still be performed on those data that have corresponding mask values equal to zero. If the data under the mask is genuinely fInotfP processable, such as NaN or infinity, the user can specify that a value be substituted in place of the original value when it is accessed. The masked data substitution attributes for a data object can be explicitly set and stored using the fISet AttributefP operator, DATAMANIP::ksetdattr.

Explicit Location and Time Data If the input object has time data or location data, it is transferred to the output object.

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:

-j
type: flag
desc: Bessel function of the first kind
OR
-y
type: flag
desc: Bessel function of the second kind

Mutually Exclusive Group; you must specify ONE of:

-ord0
type: flag
desc: Compute Bessel function of order 0
OR
-ord1
type: flag
desc: Compute Bessel function of order 1
OR
-order
type: integer
desc: Compute Bessel function of specified order
default: 2
bounds: no range checking

OPTIONAL ARGUMENTS

none

EXAMPLES

SEE ALSO

RESTRICTIONS

THIS ROUTINE is still under development, and has not been modified to fully support the polymorphic data model.

All processing is done in double precision float. If the input data is complex, only the real component of the data is processed.

REFERENCES

COPYRIGHT

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