➜
This issue tracker has been migrated to GitHub,
and is currently read-only.
For more information,
see the GitHub FAQs in the Python's Developer Guide.
Created on 2019-12-20 11:45 by cnewey, last changed 2022-04-11 14:59 by admin. This issue is now closed.
| Pull Requests | |||
|---|---|---|---|
| URL | Status | Linked | Edit |
| PR 22928 | merged | rhettinger, 2020-10-23 22:40 | |
| PR 22972 | merged | miss-islington, 2020-10-25 14:59 | |
| Messages (5) | |||
|---|---|---|---|
| msg358703 - (view) | Author: Charles Newey (cnewey) | Date: 2019-12-20 11:45 | |
The Python 3 documentation for the "random" module mentions two possible ways to generate a random variate drawn from a normal distribution - "random.gauss" and "random.normalvariate" (see: https://docs.python.org/3/library/random.html#random.gauss). It's not clear what the distinction is other than apparently the "random.gauss" function is faster. Digging through the source code, it eventually becomes apparent that "random.gauss" is NOT thread safe... but this isn't mentioned in the documentation anywhere. Further, the documentation doesn't make explicit reference to the particular method used for generating these Gaussian variates. Basically what I'm getting at is that it's difficult to tell which function ("gauss" or "randomvariate") I should be using. I feel that the documentation could be clarified here. I'm happy to do this in a PR at some point if required. |
|||
| msg358740 - (view) | Author: Terry J. Reedy (terry.reedy) *  |
Date: 2019-12-20 21:49 | |
You could start by posting suggested new text here. |
|||
| msg358754 - (view) | Author: Raymond Hettinger (rhettinger) * |
Date: 2019-12-21 01:54 | |
I can make the update for you. |
|||
| msg379580 - (view) | Author: Raymond Hettinger (rhettinger) * |
Date: 2020-10-25 14:59 | |
New changeset 3cde3788b68bce7deee1e6d31e265bbfce337731 by Raymond Hettinger in branch 'master': bpo-39108: Document threading issues for random.gauss() (GH-22928) https://github.com/python/cpython/commit/3cde3788b68bce7deee1e6d31e265bbfce337731 |
|||
| msg379583 - (view) | Author: Raymond Hettinger (rhettinger) * |
Date: 2020-10-25 15:48 | |
New changeset af891a962b62268d76ace0d4768ab0e1934a2cd1 by Miss Skeleton (bot) in branch '3.9': bpo-39108: Document threading issues for random.gauss() (GH-22928) (GH-22972) https://github.com/python/cpython/commit/af891a962b62268d76ace0d4768ab0e1934a2cd1 |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:59:24 | admin | set | github: 83289 |
| 2020-10-25 15:49:05 | rhettinger | set | status: open -> closed resolution: fixed stage: patch review -> resolved |
| 2020-10-25 15:48:41 | rhettinger | set | messages: + msg379583 |
| 2020-10-25 14:59:23 | miss-islington | set | nosy:
+ miss-islington pull_requests: + pull_request21887 |
| 2020-10-25 14:59:09 | rhettinger | set | messages: + msg379580 |
| 2020-10-23 22:40:07 | rhettinger | set | keywords:
+ patch stage: patch review pull_requests: + pull_request21850 |
| 2020-02-03 21:30:07 | mark.dickinson | set | nosy:
- mark.dickinson |
| 2019-12-21 01:54:16 | rhettinger | set | assignee: docs@python -> rhettinger messages: + msg358754 |
| 2019-12-20 21:49:30 | terry.reedy | set | nosy:
+ terry.reedy title: Documentation for "random.gauss" vs "random.normalvariate" is lacking -> random needs doc for "gauss" versus "normalvariate" messages: + msg358740 versions: - Python 3.5, Python 3.6 |
| 2019-12-20 11:54:56 | xtreak | set | nosy:
+ rhettinger, mark.dickinson |
| 2019-12-20 11:45:13 | cnewey | create | |