numpy.random.Generator.spawn

方法

random.Generator.spawn(n_children)

创建新的独立子生成器.

关于生成子代的额外说明,请参见 SeedSequence 生成.

在 1.25.0 版本加入.

参数:

n_childrenint

返回:

child_generators生成器列表

引发:

TypeError

当底层 SeedSequence 未实现生成时.

参见

random.BitGenerator.spawn, random.SeedSequence.spawn

位生成器和种子序列上的等效方法.

bit_generator

生成器使用的位生成器实例.

示例

从种子默认生成器开始:

>>> # High quality entropy created with: f"0x{secrets.randbits(128):x}"
>>> entropy = 0x3034c61a9ae04ff8cb62ab8ec2c4b501
>>> rng = np.random.default_rng(entropy)

为并行执行创建两个新的生成器,例如:

>>> child_rng1, child_rng2 = rng.spawn(2)

从每个抽取的数字是独立的,但源自初始的种子熵:

>>> rng.uniform(), child_rng1.uniform(), child_rng2.uniform()
(0.19029263503854454, 0.9475673279178444, 0.4702687338396767)

从原始的 rng 或其子进程中生成额外的子进程是安全的:

>>> more_child_rngs = rng.spawn(20)
>>> nested_spawn = child_rng1.spawn(20)