time-to-botec/squiggle/node_modules/@stdlib/math/base/special/polygamma/README.md

Polygamma

Polygamma function.

Usage

var polygamma = require( '@stdlib/math/base/special/polygamma' );

polygamma( n, x )

Evaluates the polygamma function of order n; i.e., the (n+1)th derivative of the natural logarithm of the gamma function.

var v = polygamma( 3, 1.2 );
// returns ~3.245

v = polygamma( 5, 1.2 );
// returns ~41.39

v = polygamma( 3, -4.9 );
// returns ~60014.239

If n is not a nonnegative integer, the function returns NaN.

var v = polygamma( 2.5, -1.2 );
// returns NaN

v = polygamma( -1, 5.3 );
// returns NaN

If x is 0 or a negative odd integer, the function returns +Infinity.

var v = polygamma( 2, 0.0 );
// returns +Infinity

v = polygamma( 2, -1.0 );
// returns +Infinity

If x on the other hand is a negative even integer, the function returns NaN.

v = polygamma( 2, -4.0 );
// returns NaN

v = polygamma( 2, -2.0 );
// returns NaN

If provided NaN as either parameter, the function returns NaN.

var v = polygamma( NaN, 2.1 );
// returns NaN

v = polygamma( 1, NaN );
// returns NaN

v = polygamma( NaN, NaN );
// returns NaN

Examples

var randu = require( '@stdlib/random/base/randu' );
var round = require( '@stdlib/math/base/special/round' );
var polygamma = require( '@stdlib/math/base/special/polygamma' );

var n;
var x;
var v;
var i;

for ( i = 0; i < 100; i++ ) {
    x = (randu()*100.0) - 50.0;
    n = round( randu()*50.0 );
    v = polygamma( x, n );
    console.log( 'x: %d, ψ^(%d)(x): %d', x, n, v );
}