[New-bugs-announce] [issue10787] [random.gammavariate] Add the expression of the distribution in a comprehensive form for random.gammavariate

[David Kremer]

New submission from David Kremer <david.kremer.dk at gmail.com>:

Could you please add the exact form of the distribution, because it's rather confusing in the current form.

In this url, the role of k and theta is precised with a formula :
[http://tinyurl.com/24jxfrk]*

It seems that in 
[http://docs.python.org/library/random.html#random.gammavariate] , alpha is playing the role of k and beta is playing the role of theta.

But it's still not clear, because one can confuse beta with 1/beta and vice et versa, like there is two usual representation for the gamma distribution [http://en.wikipedia.org/wiki/Gamma_distribution]

[http://docs.scipy.org/doc/numpy-1.5.x/reference/generated/numpy.random.gamma.html#numpy.random.gamma]*

Please update the documentation to avoid this ambiguity.

I provide an indicative patch which is updating the doc string in random.py

----------
assignee: docs at python
components: Documentation
files: patch_documentation_random.py.diff
keywords: patch
messages: 124803
nosy: David.Kremer, docs at python
priority: normal
severity: normal
status: open
title: [random.gammavariate] Add the expression of the distribution in a comprehensive form for random.gammavariate
versions: Python 2.7
Added file: http://bugs.python.org/file20181/patch_documentation_random.py.diff

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10787>
_______________________________________