Add comments regarding speed/space/entropy trade-offs (GH-10885)
This commit is contained in:
parent
1747334794
commit
7fc633f5a5
|
@ -333,6 +333,19 @@ class Random(_random.Random):
|
|||
# preferred since the list takes less space than the
|
||||
# set and it doesn't suffer from frequent reselections.
|
||||
|
||||
# The number of calls to _randbelow() is kept at or near k, the
|
||||
# theoretical minimum. This is important because running time
|
||||
# is dominated by _randbelow() and because it extracts the
|
||||
# least entropy from the underlying random number generators.
|
||||
|
||||
# Memory requirements are kept to the smaller of a k-length
|
||||
# set or an n-length list.
|
||||
|
||||
# There are other sampling algorithms that do not require
|
||||
# auxiliary memory, but they were rejected because they made
|
||||
# too many calls to _randbelow(), making them slower and
|
||||
# causing them to eat more entropy than necessary.
|
||||
|
||||
if isinstance(population, _Set):
|
||||
population = tuple(population)
|
||||
if not isinstance(population, _Sequence):
|
||||
|
|
Loading…
Reference in New Issue