numpy.random — Satunnaislukujen generointi

numpy.random -alimoduuli tarjoaa Generator -luokan, joka poimii näytteitä yleisistä todennäköisyysjakaumista. Taustalla oleva algoritmi on permutoitu kongruenttinen generaattori (PCG); katso lisätietoja osoitteesta https://www.pcg-random.org/.

Generator on tilallinen olio: jokainen kutsu sen näytteenottometodeihin etenee sisäistä tilaa, joten peräkkäiset kutsut palauttavat riippumattomia näytteitä. Tulostaulukot ovat aina tyyppiä numpy.float.

Luokat

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

Luo uusi pseudosatunnaislukugeneraattori.

Parametrit:

seed – generaattorin tilan alustamiseen käytetty siemenarvo. Jos annetaan kokonaisluku, sitä käytetään suoraan. Jos annetaan kokonaislukujen monikko, palautetaan yhden ilmentymän sijaan monikko itsenäisesti siemennettyjä Generator -olioita (yksi kutakin alkiota kohden). Jos annetaan None, käytetään alustan oletussiemenarvoa (kun sellainen on määritetty käännösaikana); muutoin nostetaan ValueError.

Nostaa:

  • TypeError – jos seed ei ole None, kokonaisluku tai kokonaislukujen monikko.

  • ValueError – jos seed on None eikä oletussiemenarvoa ole määritetty.

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

Poimi näytteitä normaalijakaumasta (Gaussin jakauma).

Parametrit:

  • loc – jakauman keskiarvo (keskikohta).

  • scale – jakauman keskihajonta (leveys). Tulee olla ei-negatiivinen.

  • size – tulosteen muoto. Jos kokonaisluku, palautetaan kyseisen pituinen yksiulotteinen taulukko. Jos monikko, palautetaan kyseisen muotoinen taulukko. Jos None (oletus), palautetaan yksittäinen Pythonin float.

Palauttaa:

joko Pythonin float tai pyydetyn muotoinen liukuluku-numpy.ndarray.

Nostaa:

  • ValueError – jos pyydetty muoto ylittää arvon ULAB_MAX_DIMS.

  • TypeError – jos size ei ole None, kokonaisluku eikä monikko.

Näytteet generoidaan Box-Muller-muunnoksella.

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

Poimi näytteitä tasaisesta jakaumasta puoliavoimella välillä [0.0, 1.0).

Parametrit:

  • size – tulosteen muoto. Jos kokonaisluku, palautetaan kyseisen pituinen yksiulotteinen taulukko. Jos monikko, palautetaan kyseisen muotoinen taulukko. Jos None (oletus) ja out on myös None, palautetaan yksittäinen Pythonin float.

  • out – valinnainen valmiiksi varattu, tiheä liukuluku-numpy.ndarray, johon näytteet kirjoitetaan. Jos sekä size että out annetaan, niiden muotojen tulee täsmätä.

Palauttaa:

Pythonin float, uusi numpy.ndarray tai out (täytettynä näytteillä) argumenteista riippuen.

Nostaa:

  • TypeError – jos size on tyypiltään tukematon, tai out ei ole ndarray, tai out ei ole tyyppiä float.

  • ValueError – jos pyydetty muoto ylittää arvon ULAB_MAX_DIMS, jos size ja out.shape ovat ristiriidassa, tai jos out ei ole yhtenäinen.

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

Poimi näytteitä tasaisesta jakaumasta puoliavoimella välillä [low, high).

Parametrit:

  • low – jakauman alaraja (mukaan lukien).

  • high – jakauman yläraja (poislukien).

  • size – tulosteen muoto. Jos monikko, palautetaan kyseisen muotoinen taulukko. Jos None (oletus), palautetaan yksittäinen Pythonin float väliltä [0.0, 1.0) (low/high -rajat ohitetaan skalaaritapauksessa).

Palauttaa:

joko Pythonin float tai pyydetyn muotoinen liukuluku-numpy.ndarray.

Nostaa:

  • ValueError – jos pyydetty muoto ylittää arvon ULAB_MAX_DIMS.

  • TypeError – jos size ei ole None eikä monikko.

Identtisillä oletusargumenteilla uniform() tuottaa saman sekvenssin kuin random().