Skip to main content

mrandom is a library for generating random numbers.

Project description

mrandom

This package provides a random number generator. It is based on the Mersenne Twister algorithm. It includes both 32 and 64 bit versions of the algorithm. The generator has large period of 2^19937-1

Features

  • Can generate random numbers
  • Can return a choice from a list
  • Can shuffle a list
  • Can flip a coin
  • Can roll a die
  • Can shuffle a deck

Installing the package

pip install mrandom

Importing the module

>>> import mrandom

# 1 = 32 bit, 2 = 64 bit algorithm
>>> random = mrandom.RandomGenerator(s)

Examples

Return a random number between 0 and 1

>>> print(random.rand())
0.9888888888888889

Return a random number between a and b (inclusive)

>>> print(random.randint(a, b))
1

Return a random number between a and b (exclusive)

>>> print(random.randrange(a, b))
12

Return k random numbers between a and b (inclusive)

>>> print(random.sample(a, b, k))
[1, 2, 3, 4, 5]

Return a random number from a list l

>>> print(random.choice(l))
21

Return shuffled list l

>>> print(random.shuffle(l))
[1, 3, 5, 4, 2]

Return sample of flipping k coins n times

>>> print(random.flip_coin(n, k))
[1, 0, 0, 1, 0]

Return sample of rolling k dices n times

>>> print(random.roll_dice(n, k))
[[1, 4], [1, 1]]

Return sample of picking a card from a deck of 52 cards n times

>>> print(random.shuffle_deck(n))
["Ace of Spades", "Ace of Hearts", "Ace of Clubs", "Ace of Diamonds", "Ace of Clubs"]

Classes mrandom.RandomGenerator - Random number generator

Methods:

Methods Description
rand() Return a random number between 0 and 1
randint(a, b) Return a random number between a and b (inclusive)
randrange(a, b) Return a random number between a and b (exclusive)
sample(a, b, k) Return k random numbers between a and b (inclusive)
choice(l) Return a random number from a list l
shuffle(l) Return shuffled list l
flip_coin(n, k) Return sample of flipping k coins n times
roll_dice(n, k) Return sample of rolling k dices n times
shuffle_deck(n) Return sample of picking a card from a deck of 52 cards n times

Project details


Release history Release notifications | RSS feed

This version

0.1

Download files

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

Source Distribution

py-mrandom-0.1.tar.gz (5.7 kB view hashes)

Uploaded Source

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