Median

Discrete uniform distribution median.

The median for a discrete uniform random variable is

upper M e d i a n left-bracket upper X right-bracket equals 0.5 dot left-parenthesis a plus b right-parenthesis

where a is the minimum support and b the maximum support of the distribution.

Usage

var median = require( '@stdlib/math/base/dists/discrete-uniform/median' );

median( a, b )

Returns the median of a discrete uniform distribution with parameters a (minimum support) and b (maximum support).

var v = median( 0, 1 );
// returns 0.5

v = median( 4, 12 );
// returns 8.0

v = median( 2, 8 );
// returns 5.0

If a or b is not an integer value, the function returns NaN.

var v = median( 0.1, 2 );
// returns NaN

v = median( 0, 2.2 );
// returns NaN

v = median( NaN, 2 );
// returns NaN

v = median( 2, NaN );
// returns NaN

If provided a > b, the function returns NaN.

var y = median( 3, 2 );
// returns NaN

y = median( -1, -2 );
// returns NaN

Examples

var randu = require( '@stdlib/random/base/randu' );
var round = require( '@stdlib/math/base/special/round' );
var median = require( '@stdlib/math/base/dists/discrete-uniform/median' );

var a;
var b;
var v;
var i;

for ( i = 0; i < 10; i++ ) {
    a = round( randu()*10.0 );
    b = round( ( randu()*10.0 ) + a );
    v = median( a, b );
    console.log( 'a: %d, b: %d, Median(X;a,b): %d', a.toFixed( 4 ), b.toFixed( 4 ), v.toFixed( 4 ) );
}