numpy.random — Véletlenszám-generálás

A numpy.random almodul egy Generator osztályt biztosít, amely gyakori valószínűségi eloszlásokból vesz mintákat. Az alapul szolgáló algoritmus egy permutált kongruens generátor (PCG); a részletekért lásd: https://www.pcg-random.org/.

A Generator egy állapottal rendelkező objektum: a mintavételező metódusainak minden egyes hívása előrelépteti a belső állapotot, így az egymást követő hívások független mintákat adnak vissza. A kimeneti tömbök mindig numpy.float dtype típusúak.

Osztályok

class numpy.random.Generator(seed: int | tuple[int, ...] | None = None)

Új álvéletlenszám-generátor létrehozása.

Paraméterek:

seed – a generátor állapotának inicializálásához használt mag (seed). Ha egész szám van megadva, azt közvetlenül használja. Ha egész számokból álló tuple van megadva, akkor egyetlen példány helyett függetlenül inicializált Generator objektumok tuple-jét (elemenként egyet) ad vissza. Ha None van megadva, a platform alapértelmezett magját használja (ha az fordítási időben be van állítva); ellenkező esetben ValueError kivételt dob.

Kivétel:

  • TypeError – ha a seed nem None, nem egész szám és nem egész számokból álló tuple.

  • ValueError – ha a seed None és nincs beállítva alapértelmezett mag.

normal(loc: float = 0.0, scale: float = 1.0, size: int | tuple[int, ...] | None = None) → float | ndarray

Mintavétel normál (Gauss-) eloszlásból.

Paraméterek:

  • loc – az eloszlás átlaga (középértéke).

  • scale – az eloszlás szórása (szélessége). Nem lehet negatív.

  • size – a kimenet alakja. Ha egész szám, akkor egy olyan hosszúságú egydimenziós tömböt ad vissza. Ha tuple, akkor egy ilyen alakú tömböt ad vissza. Ha None (az alapértelmezett), akkor egyetlen Python float értéket ad vissza.

Visszatérési érték:

vagy egy Python float, vagy egy float típusú numpy.ndarray a kért alakkal.

Kivétel:

  • ValueError – ha a kért alak meghaladja a ULAB_MAX_DIMS értéket.

  • TypeError – ha a size nem None, nem egész szám és nem tuple.

A mintákat a Box-Muller-transzformációval állítja elő.

random(size: int | tuple[int, ...] | None = None, *, out: ndarray | None = None) → float | ndarray

Mintavétel a [0.0, 1.0) félig nyílt intervallumon vett egyenletes eloszlásból.

Paraméterek:

  • size – a kimenet alakja. Ha egész szám, akkor egy olyan hosszúságú egydimenziós tömböt ad vissza. Ha tuple, akkor egy ilyen alakú tömböt ad vissza. Ha None (az alapértelmezett) és az out szintén None, akkor egyetlen Python float értéket ad vissza.

  • out – egy opcionális, előre lefoglalt, sűrű, float típusú numpy.ndarray, amely a mintákat fogadja. Ha mind a size, mind az out meg van adva, az alakjuknak egyezniük kell.

Visszatérési érték:

egy Python float, egy új numpy.ndarray, vagy az out (mintákkal feltöltve) az argumentumoktól függően.

Kivétel:

  • TypeError – ha a size nem támogatott típusú, vagy az out nem ndarray, vagy az out nem float dtype típusú.

  • ValueError – ha a kért alak meghaladja a ULAB_MAX_DIMS értéket, ha a size és az out.shape nem egyezik, vagy ha az out nem összefüggő.

uniform(low: float = 0.0, high: float = 1.0, size: int | tuple[int, ...] | None = None) → float | ndarray

Mintavétel a [low, high) félig nyílt intervallumon vett egyenletes eloszlásból.

Paraméterek:

  • low – az eloszlás alsó korlátja (beleértve).

  • high – az eloszlás felső korlátja (kizárva).

  • size – a kimenet alakja. Ha tuple, akkor egy ilyen alakú tömböt ad vissza. Ha None (az alapértelmezett), akkor egyetlen Python float értéket ad vissza a [0.0, 1.0) intervallumból (a low/high korlátokat a skalár esetben figyelmen kívül hagyja).

Visszatérési érték:

vagy egy Python float, vagy egy float típusú numpy.ndarray a kért alakkal.

Kivétel:

  • ValueError – ha a kért alak meghaladja a ULAB_MAX_DIMS értéket.

  • TypeError – ha a size nem None és nem tuple.

Azonos alapértelmezett argumentumokkal a uniform() ugyanazt a sorozatot állítja elő, mint a random().