{{alias}}( N, K, n ) Returns a pseudorandom number drawn from a hypergeometric distribution. `N`, `K`, and `n` must all be nonnegative integers; otherwise, the function returns `NaN`. If `n > N` or `K > N`, the function returns `NaN`. Parameters ---------- N: integer Population size. K: integer Subpopulation size. n: integer Number of draws. Returns ------- r: integer Pseudorandom number. Examples -------- > var r = {{alias}}( 20, 10, 7 ); {{alias}}.factory( [N, K, n, ][options] ) Returns a pseudorandom number generator (PRNG) for generating pseudorandom numbers drawn from a hypergeometric distribution. If provided `N`, `K`, and `n`, the returned PRNG returns random variates drawn from the specified distribution. If not provided `N`, `K`, and `n`, the returned PRNG requires that `N`, `K`, and `n` be provided at each invocation. Parameters ---------- N: integer (optional) Population size. K: integer (optional) Subpopulation size. n: integer (optional) Number of draws. options: Object (optional) Options. options.prng: Function (optional) Pseudorandom number generator (PRNG) for generating uniformly distributed pseudorandom numbers on the interval `[0,1)`. If provided, the `state` and `seed` options are ignored. In order to seed the returned pseudorandom number generator, one must seed the provided `prng` (assuming the provided `prng` is seedable). options.seed: integer|ArrayLikeObject (optional) Pseudorandom number generator seed. The seed may be either a positive unsigned 32-bit integer or, for arbitrary length seeds, an array-like object containing unsigned 32-bit integers. options.state: Uint32Array (optional) Pseudorandom number generator state. If provided, the `seed` option is ignored. options.copy: boolean (optional) Boolean indicating whether to copy a provided pseudorandom number generator state. Setting this option to `false` allows sharing state between two or more pseudorandom number generators. Setting this option to `true` ensures that a returned generator has exclusive control over its internal state. Default: true. Returns ------- rand: Function Pseudorandom number generator (PRNG). Examples -------- // Basic usage: > var rand = {{alias}}.factory(); > var r = rand( 20, 10, 15 ); > r = rand( 20, 10, 7 ); // Provide `N`, `K`, and `n`: > rand = {{alias}}.factory( 20, 10, 15 ); > r = rand(); > r = rand(); {{alias}}.NAME Generator name. Examples -------- > var str = {{alias}}.NAME 'hypergeometric' {{alias}}.PRNG Underlying pseudorandom number generator. Examples -------- > var prng = {{alias}}.PRNG; {{alias}}.seed Pseudorandom number generator seed. Examples -------- > var seed = {{alias}}.seed; {{alias}}.seedLength Length of generator seed. Examples -------- > var len = {{alias}}.seedLength; {{alias}}.state Generator state. Examples -------- > var r = {{alias}}( 20, 10, 15 ) > r = {{alias}}( 20, 10, 15 ) > r = {{alias}}( 20, 10, 15 ) // Get a copy of the current state: > var state = {{alias}}.state > r = {{alias}}( 20, 10, 15 ) > r = {{alias}}( 20, 10, 15 ) // Set the state: > {{alias}}.state = state; // Replay the last two pseudorandom numbers: > r = {{alias}}( 20, 10, 15 ) > r = {{alias}}( 20, 10, 15 ) {{alias}}.stateLength Length of generator state. Examples -------- > var len = {{alias}}.stateLength; {{alias}}.byteLength Size (in bytes) of generator state. Examples -------- > var sz = {{alias}}.byteLength; {{alias}}.toJSON() Serializes the pseudorandom number generator as a JSON object. Returns ------- out: Object JSON representation. Examples -------- > var o = {{alias}}.toJSON() { 'type': 'PRNG', 'name': '...', 'state': {...}, 'params': [] } See Also --------