Skip to main content

Common infrastructure for seeding random number generators.

Project description

Python Seed Manager

Python programs, particularly data science applications, often need to interact with multiple different random number generators.

This package provides a unified interface to seeding them, along with APIs for deriving additional RNG seeds in a predictable way (using NumPy 1.17's new random infrastructure) and constructing random generators.

Quick Start

To get started, just use the seedbank.initialize() function to seed all available random number generators:

import seedbank
seedbank.initialize(65000)

SeedBank will seed all of the known generators that will be available, including:

  • Python standard random
  • NumPy legacy random numpy.random
  • PyTorch (with torch.manual_seed())
  • Numba’s NumPy random
  • TensorFlow (with tf.random.set_seed())
  • cupy (with cupy.random.seed())

In addition, it will initialize a root seed for constructing new-style NumPy Generator instances.

If SeedBank doesn’t support your RNG yet, please submit a pull request!

Developing SeedBank

SeedBank uses Flit for managing dependencies. To set up in a fresh virtual environment:

python -m pip install flit
flit install --pth-file

[conda-lock][] can help you set up a Conda environment (replace linux-64 with your platform):

# install conda-lock in base environment
# alternatively: pip install conda-lock
conda install -c conda-forge conda-lock
# create the lock file
conda-lock -p linux-64 -f pyproject.toml
# create the environment
conda env create -n seedbank -f conda-linux-64.lock

Acknowledgements

This material is based upon work supported by the National Science Foundation under Grant No. IIS 17-51278. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seedbank-0.2.0a2.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

seedbank-0.2.0a2-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file seedbank-0.2.0a2.tar.gz.

File metadata

  • Download URL: seedbank-0.2.0a2.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for seedbank-0.2.0a2.tar.gz
Algorithm Hash digest
SHA256 a2ab1c86d362977b8217be510563ed5ae885238b60492f338c48479d60dac3d7
MD5 45c219ad57160acff4c7b9862f01f642
BLAKE2b-256 35945e3551b1d877e153d95b07942854bb156ed7b8da942e8bbd56aa2b9dacf4

See more details on using hashes here.

File details

Details for the file seedbank-0.2.0a2-py3-none-any.whl.

File metadata

  • Download URL: seedbank-0.2.0a2-py3-none-any.whl
  • Upload date:
  • Size: 11.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for seedbank-0.2.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 782a20e4e12c7ff42d8645593f67c16e549f254e9969d98e2a51b611279eaeaa
MD5 d7dbd8979be9a7bc492a4524b452b2ce
BLAKE2b-256 e116ce52c47f6cbeb6cec5f7141dd15ea858a8533278e14ef1566a7ce710d53d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page