{{alias}}( len, k[, options] ) Returns an array containing pseudorandom numbers drawn from a chi-square distribution. Parameters ---------- len: integer Output array length. k: number Degrees of freedom. options: Object (optional) Options. options.dtype: string (optional) Output array data type. Default: 'float64'. Returns ------- out: Array|Float64Array|Float32Array Output array. Examples -------- > var out = {{alias}}( 3, 2.0 ) {{alias}}.assign( k, out ) Fills an array with pseudorandom numbers drawn from a chi-square distribution. Parameters ---------- k: number Degrees of freedom. out: Array|Float64Array|Float32Array Output array. Returns ------- out: Array|Float64Array|Float32Array Output array. Examples -------- > var x = {{alias:@stdlib/array/zeros}}( 3, 'float64' ); > var out = {{alias}}.assign( 2.0, x ) > var bool = ( out === x ) true {{alias}}.factory( [k, ][options] ) Returns a function for creating arrays containing pseudorandom numbers drawn from a chi-square distribution. If provided a distribution parameter, the returned function returns random variates drawn from the specified distribution. If not provided a distribution parameter, the returned function requires that distribution parameters be provided at each invocation. The returned function accepts the following options: - dtype: output array data type. This overrides the default output array data type. Parameters ---------- k: number (optional) Degrees of freedom. 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. options.dtype: string (optional) Default output array data type. Default: 'float64'. Returns ------- fcn: Function Function for creating arrays. Examples -------- > var fcn = {{alias}}.factory(); > var out = fcn( 3, 2.0 ) // Provide distribution parameters: > fcn = {{alias}}.factory( 2.0 ); > out = fcn( 3 ) {{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 out = {{alias}}( 3, 2.0 ) // Get a copy of the current state: > var state = {{alias}}.state > out = {{alias}}( 3, 2.0 ) > out = {{alias}}( 3, 2.0 ) // Set the state: > {{alias}}.state = state; // Regenerate a previous array: > out = {{alias}}( 3, 2.0 ) {{alias}}.stateLength Length of generator state. Examples -------- > var len = {{alias}}.stateLength; {{alias}}.byteLength Size (in bytes) of generator state. Examples -------- > var sz = {{alias}}.byteLength; See Also --------