scipy.sparse.

rand#

scipy.sparse.rand(m, n, density=0.01, format='coo', dtype=None, rng=None)[Quelle]#

Erzeugt eine dünnbesetzte Matrix der gegebenen Form und Dichte mit gleichmäßig verteilten Werten.

Warnung

Diese Funktion gibt eine dünnbesetzte Matrix zurück – keine dünnbesetzte Array. Es wird empfohlen, random_array zu verwenden, um die Funktionalität von dünnbesetzten Arrays zu nutzen.

Parameter:
m, nint

Form der Matrix

densityreell, optional

Dichte der erzeugten Matrix: Eine Dichte von eins bedeutet eine volle Matrix, eine Dichte von 0 bedeutet eine Matrix ohne Nicht-Null-Elemente.

formatstr, optional

Format der dünnbesetzten Matrix.

dtypedtype, optional

Typ der Werte der zurückgegebenen Matrix.

rng{None, int, numpy.random.Generator}, optional

Wenn rng als Schlüsselwort übergeben wird, werden andere Typen als numpy.random.Generator an numpy.random.default_rng übergeben, um einen Generator zu instanziieren. Wenn rng bereits eine Generator-Instanz ist, dann wird die bereitgestellte Instanz verwendet. Geben Sie rng für reproduzierbares Funktionsverhalten an.

Wenn dieses Argument positional übergeben wird oder random_state als Schlüsselwort übergeben wird, gilt das ältere Verhalten für das Argument random_state.

  • Wenn random_state None ist (oder numpy.random), wird die Singleton-Instanz numpy.random.RandomState verwendet.

  • Wenn random_state eine Ganzzahl ist, wird eine neue RandomState-Instanz verwendet, die mit random_state initialisiert wurde.

  • Wenn random_state bereits eine Generator- oder RandomState-Instanz ist, wird diese Instanz verwendet.

Geändert in Version 1.15.0: Als Teil des Übergangs von SPEC-007 von der Verwendung von numpy.random.RandomState zu numpy.random.Generator wurde dieses Schlüsselwort von random_state in rng geändert. Für eine Übergangszeit werden beide Schlüsselwörter weiterhin funktionieren, obwohl nur eines gleichzeitig angegeben werden kann. Nach der Übergangszeit werden Funktionsaufrufe, die das Schlüsselwort random_state verwenden, Warnungen ausgeben. Das Verhalten sowohl von random_state als auch von rng ist oben beschrieben, aber nur das Schlüsselwort rng sollte in neuem Code verwendet werden.

Rückgabe:
resdünnbesetzte Matrix

Siehe auch

random

Ähnliche Funktion, die einen benutzerdefinierten Zufallsdatengenerator ermöglicht

random_array

Ähnlich wie random(), gibt aber ein dünnbesetztes Array zurück

Hinweise

Nur Gleitkommatypen werden derzeit unterstützt.

Beispiele

>>> from scipy.sparse import rand
>>> matrix = rand(3, 4, density=0.25, format="csr", rng=42)
>>> matrix
<Compressed Sparse Row sparse matrix of dtype 'float64'
    with 3 stored elements and shape (3, 4)>
>>> matrix.toarray()
array([[0.05641158, 0.        , 0.        , 0.65088847],  # random
       [0.        , 0.        , 0.        , 0.14286682],
       [0.        , 0.        , 0.        , 0.        ]])