numpy-ts 0.12.0 → 0.13.0

package/dist/types/ops/random.d.ts

@@ -1,136 +0,0 @@
-/**
- * Random number generation module
- *
- * Implements NumPy-compatible random functions:
- * - Legacy API (np.random.seed, random, rand, uniform, etc.) uses MT19937
- * - Modern API (np.random.default_rng) uses PCG64 with SeedSequence
- *
- * Both implementations produce identical output to NumPy when seeded.
- */
-import { ArrayStorage } from '../core/storage';
-import { type DType } from '../core/dtype';
-/**
- * Random number generator class (matches NumPy's Generator from default_rng)
- */
-export declare class Generator {
-    private _pcgState;
-    constructor(seedValue?: number);
-    private _randomFloat;
-    random(size?: number | number[]): ArrayStorage | number;
-    integers(low: number, high?: number, size?: number | number[]): ArrayStorage | number;
-    standard_normal(size?: number | number[]): ArrayStorage | number;
-    normal(loc?: number, scale?: number, size?: number | number[]): ArrayStorage | number;
-    uniform(low?: number, high?: number, size?: number | number[]): ArrayStorage | number;
-    choice(a: number | ArrayStorage, size?: number | number[], replace?: boolean, p?: ArrayStorage | number[]): ArrayStorage | number;
-    permutation(x: number | ArrayStorage): ArrayStorage;
-    shuffle(x: ArrayStorage): void;
-    exponential(scale?: number, size?: number | number[]): ArrayStorage | number;
-    poisson(lam?: number, size?: number | number[]): ArrayStorage | number;
-    binomial(n: number, p: number, size?: number | number[]): ArrayStorage | number;
-}
-/**
- * Create a new Generator instance (matches np.random.default_rng)
- * @param seedValue - Optional seed value
- */
-export declare function default_rng(seedValue?: number): Generator;
-/**
- * Seed the random number generator (legacy API)
- * @param seedValue - Seed value (integer)
- */
-export declare function seed(seedValue?: number | null): void;
-/**
- * Get the internal state of the random number generator
- * @returns State object that can be used with set_state
- */
-export declare function get_state(): {
-    mt: number[];
-    mti: number;
-};
-/**
- * Set the internal state of the random number generator
- * @param state - State object from get_state
- */
-export declare function set_state(state: {
-    mt: number[];
-    mti: number;
-}): void;
-/**
- * Generate random floats in the half-open interval [0.0, 1.0)
- * @param size - Output shape. If not provided, returns a single float.
- */
-export declare function random(size?: number | number[]): ArrayStorage | number;
-/**
- * Random values in a given shape (alias for random with shape)
- * @param d0, d1, ..., dn - The dimensions of the returned array
- */
-export declare function rand(...shape: number[]): ArrayStorage | number;
-/**
- * Return random floats from standard normal distribution
- * @param d0, d1, ..., dn - The dimensions of the returned array
- */
-export declare function randn(...shape: number[]): ArrayStorage | number;
-/**
- * Return random integers from low (inclusive) to high (exclusive)
- * @param low - Lowest integer (or high if high is not provided)
- * @param high - One above the highest integer (optional)
- * @param size - Output shape
- * @param dtype - Output dtype (default 'int64')
- */
-export declare function randint(low: number, high?: number | null, size?: number | number[], dtype?: DType): ArrayStorage | number;
-/**
- * Draw samples from a uniform distribution
- * @param low - Lower boundary (default 0)
- * @param high - Upper boundary (default 1)
- * @param size - Output shape
- */
-export declare function uniform(low?: number, high?: number, size?: number | number[]): ArrayStorage | number;
-/**
- * Draw samples from a normal (Gaussian) distribution
- * @param loc - Mean of the distribution (default 0)
- * @param scale - Standard deviation (default 1)
- * @param size - Output shape
- */
-export declare function normal(loc?: number, scale?: number, size?: number | number[]): ArrayStorage | number;
-/**
- * Draw samples from a standard normal distribution (mean=0, std=1)
- * @param size - Output shape
- */
-export declare function standard_normal(size?: number | number[]): ArrayStorage | number;
-/**
- * Draw samples from an exponential distribution
- * @param scale - The scale parameter (beta = 1/lambda) (default 1)
- * @param size - Output shape
- */
-export declare function exponential(scale?: number, size?: number | number[]): ArrayStorage | number;
-/**
- * Draw samples from a Poisson distribution
- * @param lam - Expected number of events (lambda) (default 1)
- * @param size - Output shape
- */
-export declare function poisson(lam?: number, size?: number | number[]): ArrayStorage | number;
-/**
- * Draw samples from a binomial distribution
- * @param n - Number of trials
- * @param p - Probability of success
- * @param size - Output shape
- */
-export declare function binomial(n: number, p: number, size?: number | number[]): ArrayStorage | number;
-/**
- * Generate a random sample from a given 1-D array
- * @param a - Input array or int. If int, samples from arange(a)
- * @param size - Output shape
- * @param replace - Whether sampling with replacement (default true)
- * @param p - Probabilities associated with each entry
- */
-export declare function choice(a: number | ArrayStorage, size?: number | number[], replace?: boolean, p?: ArrayStorage | number[]): ArrayStorage | number;
-/**
- * Randomly permute a sequence, or return a permuted range
- * @param x - Input array or int. If int, returns permutation of arange(x)
- */
-export declare function permutation(x: number | ArrayStorage): ArrayStorage;
-/**
- * Modify a sequence in-place by shuffling its contents
- * @param x - Array to be shuffled
- */
-export declare function shuffle(x: ArrayStorage): void;
-//# sourceMappingURL=random.d.ts.map