e z S r SSKJrJrJrJr J
r SSKJ r
JrJrJr SSKJrJrJr SSKJrJ r J r SSK J!r" SSK#J$r% SSK&J'r( SS K)J*r+J,r- SS
K.J.r/ SS K r0SS K1r1/ S Qr2S
\" S5 - \
" S5 - r3\" S5 r4S\" S5 - r5Sr6S\6* - r7Sr8S q9 " S S\1Rt 5 r: " S S\:5 r;\:" 5 r<\\ US:X a [ U[ [ 45 ( a} [ U[ 5 ( a UR S5 OUnU( a [ US 5 S- OSn[ [ U5 H nSU- U- S- nM U[
U5 - nUS:X a SOUnOUS :X a [ U[ [ [ 45 ( ac [ c SS K J
q [ U[ 5 ( a UR 5 n[ R U[ U5 R! 5 - 5 nO?[ U[# S
5 [ [$ [ [ [ 45 ( d [' S 5 e[( TU ]U U5 S
U l g
! [ a SS K J
q Nf = f)
a Initialize internal state from a seed.
The only supported seed types are None, int, float,
str, bytes, and bytearray.
None or no argument seeds from current time or from an operating
system specific randomness source if available.
If *a* is an int, all bits are used.
For version 2 (the default), all of the bits are used if *a* is a str,
bytes, or bytearray. For version 1 (provided for reproducing random
sequences from older versions of Python), the algorithm for str and
bytes generates a narrower range of seeds.
r9 zlatin-1r iCB l r8 N)sha512zOThe only supported seed types are:
None, int, float, str, bytes, and bytearray.)
isinstancestrbytesdecodeordmaplen bytearray_sha512_sha2rI ImportErrorhashlibencodeint
from_bytesdigesttypefloat TypeErrorsuperr+ r> )r? aversionr@ c __class__s rA r+ Random.seed sI $ a U R [ TU ] 5 U R 4$ )z9Return internal state; can be passed to setstate() later.)VERSIONr] r" r> )r? ra s rA r" Random.getstate s ||UW - / @@rD c > US nUS:X a Uu p#U l [ TU ] U5 gUS:X a- Uu p#U l [ S U 5 5 n[ TU ] U5 g[ SU< SU R < 35 e! [ a n[
UeSnAff = f)z:Restore internal state from object returned by getstate().r r< r8 c 3 * # U H oS - v M g7f)l N ).0r@ s rA "Random.setstate.. s %K]7m]s Nzstate with version z( passed to Random.setstate() of version )r> r] r, tuple
ValueErrorr\ rd )r? stater_
internalstater ra s rA r, Random.setstate s ( a<6; 3GDO G ] +
\6; 3GDO
' %%K]%K K
G ] + %t|| 5 6
6
' Q&
's A7 7
B
BB
c " U R 5 $ N)r" r? s rA __getstate__Random.__getstate__ s }} rD c & U R U5 g rr )r, )r? rn s rA __setstate__Random.__setstate__ s
e rD c < U R SU R 5 4$ )Nrh )ra r" rs s rA
__reduce__Random.__reduce__ s ~~r4==?22rD c U R H[ nSUR ; a gSUR ; a U R U l gSUR ; d MJ U R U l g g)zControl how subclasses generate random integers.
The algorithm a subclass can use depends on the random() and/or
getrandbits() implementation available to it and determines
whether it can generate random integers from arbitrarily large
ranges.
_randbelowr! r( N)__mro____dict___randbelow_with_getrandbitsr} _randbelow_without_getrandbits)clskwargsr` s rA __init_subclass__Random.__init_subclass__ sY Aqzz)
*!$!@!@1::%!$!C!C rD c v U R nUR 5 nU" U5 nXA: a U" U5 nXA: a M U$ )z;Return a random int in the range [0,n). Defined for n > 0.)r!
bit_length)r? nr! krs rA r "Random._randbelow_with_getrandbits s= &&
LLN NfAA frD r9 c U R nX: a! SSKJn U" S5 [ U" 5 U- 5 $ X!- nX%-
U- nU" 5 nXv: a U" 5 nXv: a M [ Xr- 5 U- $ )z{Return a random int in the range [0,n). Defined for n > 0.
The implementation does not use getrandbits, but only random.
r )warnzUnderlying random() generator does not supply
enough bits to choose from a population range this large.
To remove the range limitation, add a getrandbits() method.)r( warningsr _floor)r? r maxsizer( r remlimitr s rA r %Random._randbelow_without_getrandbits sv < % O
P &(Q,' 'k ') HjA jak"Q&&rD c J U R US- 5 R US5 $ )Generate n random bytes. little)r! to_bytesr? r s rA r& Random.randbytes s$ A&//8<?? U5\Q7J F?IJz!vj 45zJ JOO A{{ KL L! q5 qE$q1ua. 11 1G <
#D1X ae$ G 1uqy/
uH#<? ?
U q)+)A 6+vx%/?BGH)+ ++ S
!'3// KM
$+s DD ! D=3D:c 2 XU-
U R 5 - - $ )zGet a random number in the range [a, b) or [a, b] depending on rounding.
The mean (expected value) and variance of the random variable are:
E[X] = (a + b) / 2
Var[X] = (b - a) ** 2 / 12
r( r s rA r/ Random.uniform s ET[[]***rD c U R 5 n Uc SOX1-
X!-
- nXE: a SU-
nSU-
nX!p!XU-
[ XE- 5 - - $ ! [ a Us $ f = f)au Triangular distribution.
Continuous distribution bounded by given lower and upper limits,
and having a given mode value in-between.
http://en.wikipedia.org/wiki/Triangular_distribution
The mean (expected value) and variance of the random variable are:
E[X] = (low + high + mode) / 3
Var[X] = (low**2 + high**2 + mode**2 - low*high - low*mode - high*mode) / 18
?r5 )r( ZeroDivisionError_sqrt)r? lowhighmodeur` s rA r. Random.triangular st
KKM |$*)DA
5aAaA SjE!%L000
! J s A AAc U R n U" 5 nSU" 5 -
n[ US-
- U- nXf- S- nU[ U5 * :: a OM: XU- - $ )zLNormal distribution.
mu is the mean, and sigma is the standard deviation.
r5 r r4 )r(
NV_MAGICCONSTr )r? musigmar( u1u2zzzs rA r$ Random.normalvariate sc Bvx B c*R/ABd2hY
I~ rD c U R nU R nSU l UcN U" 5 [ - n[ S[ SU" 5 -
5 - 5 n[ U5 U- n[
U5 U- U l XU- - $ )zGaussian distribution.
mu is the mean, and sigma is the standard deviation. This is
slightly faster than the normalvariate() function.
Not thread-safe without a lock around calls.
Ng r5 )r( r> TWOPIr r _cos_sin)r? r r r( r x2pig2rads rA r Random.gauss+ sr 6 OO 98e#D$cFHn!556ET
U"A "4j5 0DOI~ rD c 6 [ U R X5 5 $ )zLog normal distribution.
If you take the natural logarithm of this distribution, you'll get a
normal distribution with mean mu and standard deviation sigma.
mu can have any value, and sigma must be greater than zero.
)_expr$ )r? r r s rA r# Random.lognormvariateQ s D&&r122rD c B [ SU R 5 -
5 * U- $ )a Exponential distribution.
lambd is 1.0 divided by the desired mean. It should be
nonzero. (The parameter would be called "lambda", but that is
a reserved word in Python.) Returned values range from 0 to
positive infinity if lambd is positive, and from negative
infinity to 0 if lambd is negative.
The mean (expected value) and variance of the random variable are:
E[X] = 1 / lambd
Var[X] = 1 / lambd ** 2
r5 )r r( )r? lambds rA r Random.expovariate[ s" $ S4;;=())E11rD c U R nUS:: a [ U" 5 - $ SU- nU[ SXD- - 5 - n U" 5 n[ [ U- 5 nXuU- - nU" 5 n U SX- -
: d U SU-
[ U5 - :: a OMJ SU- n
X- SX- - - n U" 5 n U S: a U[
U 5 - [ - n
U
$ U[
U 5 -
[ - n
U
$ )a Circular data distribution.
mu is the mean angle, expressed in radians between 0 and 2*pi, and
kappa is the concentration parameter, which must be greater than or
equal to zero. If kappa is equal to zero, this distribution reduces
to a uniform random angle over the range 0 to 2*pi.
gư>r r5 )r( r r r _pir _acos)r? r kappar( r r r r dr qfu3thetas rA r0 Random.vonmisesvariateo s D=68# # %K
cAEk" "BS2XAU ABC!%K 2#'T!W)<#<
!G
UsQU{ #
X
8%(]e+E %(]e+E rD c US:: d US:: a [ S5 eU R nUS: a [ SU- S-
5 nU[ -
nX- n U" 5 nSUs=: a S: d O M SU" 5 -
n[ USU-
- 5 U- n U[ U 5 - n
Xw- U- n XVU - - U
-
n U [ - SU - -
S: d U [ U 5 : a X- $ M} US:X a [ SU" 5 -
5 * U- $ U" 5 n
[ U- [ - nX- nUS:: a USU- - n
O[ X-
U- 5 * n
U" 5 nUS: a XzUS-
- :: a X- $ OU[ U
* 5 :: a X- $ Mp )a Gamma distribution. Not the gamma function!
Conditions on the parameters are alpha > 0 and beta > 0.
The probability distribution function is:
x ** (alpha - 1) * math.exp(-x / beta)
pdf(x) = --------------------------------------
math.gamma(alpha) * beta ** alpha
The mean (expected value) and variance of the random variable are:
E[X] = alpha * beta
Var[X] = alpha * beta ** 2
r z*gammavariate: alpha and beta must be > 0.0r5 r3 gHz>gP?r6 )rm r( r LOG4r r
SG_MAGICCONST_e)r? alphabetar( ainvbbbcccr r vr@ r r r r ps rA r Random.gammavariate s ( C<43; IJ J 3; us*+D$,C,CXb,9, 68^sRx )D0DGOGbL'MA%}$sQw.#5d1g 8O c\vx ((4/ /
H%Z2%E8cEk*A quo..AXs753; // 8O 048^8O rD c d U R US5 nU( a X3U R US5 - - $ g)a! Beta distribution.
Conditions on the parameters are alpha > 0 and beta > 0.
Returned values range between 0 and 1.
The mean (expected value) and variance of the random variable are:
E[X] = alpha / (alpha + beta)
Var[X] = alpha * beta / ((alpha + beta)**2 * (alpha + beta + 1))
r5 r )r )r? r r ys rA r Random.betavariate s7 6
eS ) D - -dC 889 9rD c 8 SU R 5 -
nUSU- - $ )z3Pareto distribution. alpha is the shape parameter.r5 g r )r? r r s rA r% Random.paretovariate s#
$++- TE\""rD c R SU R 5 -
nU[ U5 * SU- - - $ )zVWeibull distribution.
alpha is the scale parameter and beta is the shape parameter.
r5 )r( r )r? r r r s rA r1 Random.weibullvariate s.
$++- acDj111rD c US: a [ S5 eUS:: d US: a US:X a gUS:X a U$ [ S5 eU R nUS:X a [ U" 5 U: 5 $ US: a XR USU-
5 -
$ X- S: aK S=pE[ SU-
5 nU( d U$ U[ [ U" 5 5 U- 5 S- -
nXQ: a U$ US-
nM0 X- S: a US:: d eS
n[
X- SU-
- 5 nS S U- - n S
SU - - SU- - n
X- S- nSSU - -
n U" 5 n U S- n S[ U 5 -
n
[ SU
- U
- U - U - U- 5 nUS: d X: a MB U" 5 nU
S: a X:: a U$ U( dO SSU - - U- n[ USU-
- 5 n[ US- U- 5 n[ US- 5 [ UU-
S- 5 - nS nUWXU
- - U - - - n[ U5 W[ US- 5 -
[ X -
S- 5 -
UW-
W- - :: a U$ M )aZ Binomial random variable.
Gives the number of successes for *n* independent trials
with the probability of success in each trial being *p*:
sum(random() < p for i in range(n))
Returns an integer in the range: 0 <= X <= n
The mean (expected value) and variance of the random variable are:
E[X] = n * p
Var[x] = n * p * (1 - p)
r zn must be non-negativer r5 z&p must be in the range 0.0 <= p <= 1.0r9 r g $@TFgffffff?g=
ףp=@gEJYga+e?{Gz?gq=
ףp?g@r3 gQ ?gp=
ף@gffffff@)
rm r( r r _log2r r _fabsr _lgamma)r? r r r( r@ r r` setup_completespqr r^ vrr usr r r lpqmhs rA r Random.binomialvariate s| "
q5 56 6 8qCxCxCx EF F
6&(Q,' '
s7++AsQw77 7 54< IAcAgAVE&(Oa /01445 HQ sd{qCx'' AES1W%& 4#: fqj 4!8 +
ECK
C!G^A
HAuQx Ba" q(A-12A1u ATzag
" a 3.1a=)AEQ;'AENWQUQY%77!%
!Bw-!+, ,AAw!ga!en,wquqy/AAQUcMQQ5 rD )r> rr )Nr8 )r r5 Nr r5 )r5 )r9 r )(__name__
__module__ __qualname____firstlineno____doc__rd rB r+ r" r, rt rw rz r r BPFr r} r& r r) r' r r- r* r r/ r. r$ r r# r r0 r r r% r1 r __static_attributes__
__classcell__)ra s @rA r r g s G . `A6B 3 ( 9:3 '( -J= %)t '3R&.$ /3 ]~#+tq #+P +12 *$ L32((TC J @# 2 V VrD r c > \ rS rSrSrS rS rS rS rS r \ =r
r Sr g )
r ip zAlternate random number generator using sources provided
by the operating system (such as /dev/urandom on Unix or
CryptGenRandom on Windows).
Not available on all systems (see os.urandom() for details).
c R [ R [ S5 5 S- [ - $ )z7Get the next random number in the range 0.0 <= X < 1.0.rF r< )rW rX _urandom RECIP_BPFrs s rA r( SystemRandom.randomy s x{+q0I==rD c US: a [ S5 eUS- S- n[ R [ U5 5 nX2S- U-
- $ )z:getrandbits(k) -> x. Generates an int with k random bits.r z#number of bits must be non-negativerF r )rm rW rX r- )r? r numbytesr@ s rA r! SystemRandom.getrandbits} sG q5 BC CEa< NN8H- .\A%&&rD c [ U5 $ )r )r- r s rA r& SystemRandom.randbytes s {rD c g)z' P *)HxrD r c 4 SSK JnJn SSKJn U" 5 n[ S U 5 Vs/ s H oq" U6 PM nnU" 5 n U" U5 n
U" X5 n [
U5 n [ U5 n
[ X-
S SU SUR U< 35 [ SXX4- 5 g s snf )Nr )stdevfmean) perf_counterz.3fz sec, z times z"avg %g, stddev %g, min %g, max %g
)
statisticsr? r@ timerA r minmaxprintr# )r funcr7 r? meanrA t0r datat1xbarr r r s rA _test_generatorrM s /! B!(q!1 2!1AD$K!1D 2 B :D $ E
d)C t9D RWSMs'$--
AB
/42J
JK 3s Bc h [ U [ S5 [ U [ S5 [ U [ S5 [ U [ S5 [ U [
S5 [ U [
S5 [ U [ S5 [ U [ S5 [ U [ S5 [ U [ S5 [ U [ S 5 [ U [ S
5 [ U [ S 5 [ U [ S 5 [ U [ S
5 [ U [ S5 [ U [ S5 [ U [ S5 g )Nrh r" ) g333333?)d g ?)r r5 )皙?r5 )rQ r3 )r r5 )g?r5 )r5 r5 )r3 r5 )g 4@r5 )g i@r5 ) @rR )r r5 gUUUUUU?)
rM r( r$ r# r0 r r r r r. )Ns rA _testrT s Avr"A}j1A~z2A
3A
3A 4A|[1A|Z0A|Z0A|Z0A|Z0A|Z0A|Z0A|[1A|\2Auj)A{J/Az#89rD fork)after_in_childarg_listc SS K nUR UR S9nUR 5 nUR SSSSS9 UR SS [
S
S S 9 UR S
S[ S
SS 9 UR S[
SSUR S9 UR SSSS9 UR U 5 nXBR 5 4$ )Nr )formatter_classz-cz--choice+zprint a random choice)nargshelpz-iz --integerrS z0print a random integer between 1 and N inclusive)rZ metavarr\ z-fz--floatz>print a random floating-point number between 0 and N inclusivez--test' ?)rZ constr[ r\ input*zif no options given, output depends on the input
string or multiple: same as --choice
integer: same as --integer
float: same as --float)
argparseArgumentParserRawTextHelpFormatter add_mutually_exclusive_group add_argumentrW r[ SUPPRESS
parse_args format_help)rW rc parsergroupr7 s rA _parse_argsrm s
$
$ 55 % 7F / / 1E j
$ &
kS
? A
ieS
M O
s&
s X &D ##% %%rD returnc [ U 5 u pUR ( a [ UR 5 $ UR b [ SUR 5 $ UR b [ SUR 5 $ UR ( a [ UR 5 g[ UR 5 S:X a' UR S n [ U5 n[ SU5 $ [ UR 5 S: a [ UR 5 $ U$ ! [ aF [ U5 n[ SU5 s $ ! [ a [ UR 5 5 s s $ f = ff = f)Nr9 r r8 )
rm r integerr' r[ r/ testrT rP ra rW rm split)rW r7 help_textvals rA mainrv s !(+OD {{dkk"" || q$,,'' zz q$**%% yy
dii 4::!jjm +c(C1c? " 4::!djj!! +
+Cj q#&
+ ciik**
+ +s0
D
E! D52E!5#E E! E E!__main__)r^ rr )`r' mathr r r r r r r r r r r r r r r
r r r r r r
r r r r r r r r r osr r- _collections_abcr r operatorr r itertoolsr r r r r r _os_random__all__r r r r( r. r rR r r _instr+ r( r/ r. r' r r) r* r- r r$ r# r r0 r r r r r% r1 r" r, r! r& rM rT hasattrregister_at_forkr rK rm rW rv r# rF rh rD rA r s .h M L G G E E @ @ " 2 $ B $ : DJs+
Cyd3i
#I
B W^^ B R"*6 "*X zz
--
-- OO
--
--##
%% ''!!
''##
%% >> >> OO L":0 3
3&$s)d* &6$49t# $sSy $N z $&M rD