SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 2 Vol 1

CHM

Name:
    CHM (LET)
    Library Function
Purpose:
    Compute the confluent hypergeometric M function with shape parameters A and B.
Description:
    The Handbook of Mathematical Functions (see the REFERENCE section below) defines 2 confluent hypergeometric functions: M and U. This command computes the M function. The CHU function computes the U function. The integral representation of the confluent hypergeometric M function is

      formula for confluent hypergeometric M function

    Note that the standard form is M(a,b,z). Dataplot uses M(z,a,b) to be more consistent with how other functions are entered. DATAPLOT only computes this function for real values.

    Many common functions can be defined as special cases of this function (see table 13.6 in the Handbook of Mathematical Functions).

    The input value must be a positive real number. The B shape parameter should not be 0 or a negative integer.

    Dataplot computes these function using the CHGM routine from "Computation of Special Functions" (see the References section below).

Syntax:
    LET <y2> = CHM(<x>,<a>,<b>)             <SUBSET/EXCEPT/FOR qualification>
    where <x> is a positive number, variable, or parameter;
                <a> is a number, variable, or parameter;
                <b> is a number, variable, or parameter;
                <y2> is a variable or a parameter (depending on what <a> and <b> are) where the computed values are stored;
    and where the <SUBSET/EXCEPT/FOR qualification> is optional.
Examples:
    LET Z = CHM(0.01,0.1,0.2)
    LET Z = CHM(1,0.1,0.2)
    LET Z = CHM(0.1,-1.3,0.1)
Default:
    None
Synonyms:
    None
Related Commands:
    CHU = Compute the confluent hypergeometric U function.
    BETA = Compute the complete Beta function.
    BETAI = Compute the incomplete Beta function.
    GAMMA = Compute the gamma function.
    LOGGAMMA = Compute the log gamma function.
Reference:
    "Computation of Special Functions", Shanjie Zhang and Jianming Jin, John Wiley and Sons, 1996, chapter 12.

    "Handbook of Mathematical Functions, Applied Mathematics Series, Vol. 55", Abramowitz and Stegun, National Bureau of Standards, 1964.

Applications:
    Special Functions
Implementation Date:
    1997/12
Program:
    MULTIPLOT 2 2
    MULTIPLOT CORNER COORDINATES 5 5 95 95
    TITLE AUTOMATIC
    PLOT CHM(X,0.1,0.2) FOR X = 0 0.01 5
    PLOT CHM(X,1,2) FOR X = 0 0.01 5
    PLOT CHM(X,0.5,4) FOR X = 0 0.01 5
    PLOT CHM(X,5,10) FOR X = 0 0.01 5
    END OF MULTIPLOT
    MOVE 50 97
    JUSTIFICATION CENTER
    TEXT CONFLUENT HYPERGEOMETRIC M FUNCTIONS

    plot generated by sample program

Date created: 6/5/2001
Last updated: 4/4/2003
Please email comments on this WWW page to alan.heckert@nist.gov.