R: Gaussian hypergeometric2F1 function

hypergeometric2F1 {BAS} | R Documentation

## Gaussian hypergeometric2F1 function

### Description

Compute the Gaussian Hypergeometric2F1 function: 2F1(a,b,c,z) = Gamma(b-c) Int_0^1 t^(b-1) (1 - t)^(c -b -1) (1 - t z)^(-a) dt

### Usage

    hypergeometric2F1(a, b, c, z, method = "Cephes", log = TRUE)

### Arguments

`a` | arbitrary
`b` | Must be greater 0
`c` | Must be greater than b if |z| < 1, and c > b + a if z = 1
`z` | |z| <= 1
`method` | The default is to use the Cephes library routine. This sometimes is unstable for large a or z near one returning Inf or negative values. In this case, try method="Laplace", which use a Laplace approximation for tau = exp(t/(1-t)).
`log` | if TRUE, return log(2F1)

### Details

The default is to use the routine hyp2f1.c from the Cephes library. If that return a negative value or Inf, one should try method="Laplace" which is based on the Laplace approximation as described in Liang et al JASA 2008. This is used in the hyper-g prior to calculate marginal likelihoods.

### Value

if log=T returns the log of the 2F1 function; otherwise the 2F1 function.

### Author(s)

Merlise Clyde (clyde@duke.edu)

### References

Cephes library hyp2f1.c

Liang, F., Paulo, R., Molina, G., Clyde, M. and Berger, J.O. (2005) Mixtures of g-priors for Bayesian Variable Selection. Journal of the American Statistical Association. 103:410-423.
doi: 10.1198/016214507000001337

### See Also

Other special functions: `hypergeometric1F1()`, `phi1()`, `trCCH()`

### Examples

    hypergeometric2F1(12, 1, 2, .65)

[Package BAS version 1.6.2 Index]