UNPKG

@stdlib/stats

Version:

Standard library statistical functions.

65 lines (50 loc) 1.25 kB
{{alias}}( x, p ) Evaluates the probability mass function (PMF) for a geometric distribution with success probability `p` at a value `x`. If provided `NaN` as any argument, the function returns `NaN`. If `p < 0` or `p > 1`, the function returns `NaN`. Parameters ---------- x: number Input value. p: number Success probability. Returns ------- out: number Evaluated PMF. Examples -------- > var y = {{alias}}( 4.0, 0.3 ) ~0.072 > y = {{alias}}( 2.0, 0.7 ) ~0.063 > y = {{alias}}( -1.0, 0.5 ) 0.0 > y = {{alias}}( 0.0, NaN ) NaN > y = {{alias}}( NaN, 0.5 ) NaN // Invalid success probability: > y = {{alias}}( 2.0, 1.5 ) NaN {{alias}}.factory( p ) Returns a function for evaluating the probability mass function (PMF) of a geometric distribution with success probability `p`. Parameters ---------- p: number Success probability. Returns ------- pmf: Function Probability mass function (PMF). Examples -------- > var mypmf = {{alias}}.factory( 0.5 ); > var y = mypmf( 3.0 ) 0.0625 > y = mypmf( 1.0 ) 0.25 See Also --------