FNLMath : Introduction : Organization of the Documentation
Organization of the Documentation
This manual contains a concise description of each routine, with at least one demonstrated example of each routine, including sample input and results. You will find all information pertaining to the MATH/LIBRARY in this manual. Moreover, all information pertaining to a particular routine is in one place within a chapter.
Each chapter begins with an introduction followed by a table of contents that lists the routines included in the chapter. Documentation of the routines consists of the following information:
*IMSL Routine’s Generic Name
*Purpose: a statement of the purpose of the routine. If the routine is a function rather than a subroutine the purpose statement will reflect this fact.
*Function Return Value: a description of the return value (for functions only).
*Required Arguments: a description of the required arguments in the order of their occurrence. Input arguments usually occur first, followed by input/output arguments, with output arguments described last. Futhermore, the following terms apply to arguments:
*Input Argument must be initialized; it is not changed by the routine.
*Input/Output Argument must be initialized; the routine returns output through this argument; cannot be a constant or an expression.
*Input[/Output] Argument must be initialized; the routine may return output through this argument based on other optional data the user may choose to pass to this routine; cannot be a constant or an expression.
*Input or Output Select appropriate option to define the argument as either input or output. See individual routines for further instructions.
*Output No initialization is necessary; cannot be a constant or an expression. The routine returns output through this argument.
*Optional Arguments: a description of the optional arguments in the order of their occurrence.
*Fortran 90 Interface: a section that describes the generic and specific interfaces to the routine.
*Fortran 77 Style Interface: an optional section, which describes Fortran 77 style interfaces, is supplied for backwards compatibility with previous versions of the Library.
*ScaLAPACK Interface: an optional section, which describes an interface to a ScaLAPACK‑based version of this routine.
*Description: a description of the algorithm and references to detailed information. In many cases, other IMSL routines with similar or complementary functions are noted.
*Comments: details pertaining to code usage.
*Programming notes: an optional section that contains programming details not covered elsewhere.
*Example: at least one application of this routine showing input and required dimension and type statements.
*Output: results from the example(s). Note that unique solutions may differ from platform to platform.
*Additional Examples: an optional section with additional applications of this routine showing input and required dimension and type statements.
Published date: 03/19/2020
Last modified date: 03/19/2020