MonkeyScope 1.2.3

Distribution Stats & Timer for Testing Non-deterministic Value Generators

MonkeyScope

Distribution Timer for Non-deterministic Value Generators

Sister Projects:

• Fortuna: Collection of abstractions to make custom random value generators. https://pypi.org/project/Fortuna/
• Pyewacket: Complete drop-in replacement for the Python3 random module. https://pypi.org/project/Pyewacket/
• RNG: Python3 API for the C++ Random Library. https://pypi.org/project/RNG/

Support these and other random projects: https://www.patreon.com/robertsharp

Quick Install

$ pip install MonkeyScope
$ python3
>>> import MonkeyScope

Installation may require the following:

• Python 3.6 or later with dev tools (setuptools, pip, etc.)
• Cython: pip install Cython
• Modern C++17 compiler and standard library for your platform.

---

MonkeyScope Specifications

• MonkeyScope.distribution_timer(func: staticmethod, *args, **kwargs) -> None
  • Logger for the statistical analysis of non-deterministic generators.
  • @param func :: function, method or lambda to analyze. Evaluated as func(*args, **kwargs)
  • @optional_kw num_cycles=10000 :: Total number of samples to use for analysis.
  • @optional_kw post_processor=None :: Used to scale a large set of data into a smaller set of groupings for better visualization of the data, esp. useful for distributions of floats. For many functions in quick_test(), math.floor() is used, for others round() is more appropriate. For more complex post processing - lambdas work nicely. Post processing only affects the distribution, the statistics and performance results are unaffected.
• MonkeyScope.distribution(func: staticmethod, *args, **kwargs) -> None
  • Stats and distribution.
• MonkeyScope.timer(func: staticmethod, *args, **kwargs) -> None
  • Just the function timer.

MonkeyScope Terminal Example

$ python3
Python 3.7.4
>>> import MonkeyScope, random
>>> MonkeyScope.timer(random.random)
Typical Timing: 32 ± 12 ns

MonkeyScope Script Example

import MonkeyScope, random


x, y, z = 1, 10, 2
MonkeyScope.distribution_timer(random.randint, x, y)
MonkeyScope.distribution_timer(random.randrange, x, y)
MonkeyScope.distribution_timer(random.randrange, x, y, z)

Typical Script Output

Output Analysis: Random.randint(1, 10)
Typical Timing: 1270 ± 88 ns
Statistics of 1000 samples:
 Minimum: 1
 Median: 5.0
 Maximum: 10
 Mean: 5.425
 Std Deviation: 2.867468395641005
Distribution of 100000 samples:
 1: 10.0%
 2: 10.073%
 3: 10.046%
 4: 10.07%
 5: 10.032%
 6: 9.991%
 7: 9.978%
 8: 10.115%
 9: 9.836%
 10: 9.859%

Output Analysis: Random.randrange(1, 10)
Typical Timing: 1135 ± 69 ns
Statistics of 1000 samples:
 Minimum: 1
 Median: 5.0
 Maximum: 9
 Mean: 5.028
 Std Deviation: 2.605228588819031
Distribution of 100000 samples:
 1: 11.281%
 2: 11.098%
 3: 11.04%
 4: 11.119%
 5: 10.999%
 6: 11.176%
 7: 11.206%
 8: 11.091%
 9: 10.99%

Output Analysis: Random.randrange(1, 10, 2)
Typical Timing: 1332 ± 55 ns
Statistics of 1000 samples:
 Minimum: 1
 Median: 5.0
 Maximum: 9
 Mean: 5.068
 Std Deviation: 2.771890329720857
Distribution of 100000 samples:
 1: 19.868%
 3: 20.025%
 5: 20.001%
 7: 19.811%
 9: 20.295%

Development Log:

MonkeyScope 1.2.3

• Minor typos fixed.

MonkeyScope 1.2.2

• MonkeyScope is now compatible with python notebooks.

MonkeyScope 1.2.1

• Documentation update

MonkeyScope 1.2.0

• Minor performance improvement.

MonkeyScope 1.1.5

• Public Release

MonkeyScope Beta 0.1.5

• Installer Update

MonkeyScope Beta 0.1.4

• Minor Bug Fix

MonkeyScope Beta 0.1.3

• Continued Development

MonkeyScope Beta 0.1.2

• Renamed to MonkeyScope

MonkeyTimer Beta 0.0.2

• Changed to c++ compiler

MonkeyTimer Beta 0.0.1

• Initial Project Setup