diff options
| author | mattip <matti.picus@gmail.com> | 2019-11-21 08:31:05 -0800 |
|---|---|---|
| committer | mattip <matti.picus@gmail.com> | 2019-11-21 16:47:30 -0800 |
| commit | a413620ed8c13efc1f513859e3140ad6922d67d0 (patch) | |
| tree | 77a79eeda4ed8aa89d0166022bf0a59e58129c15 /doc/source/reference/random/legacy.rst | |
| parent | 5a52be5d12773327f950fd67ad9268dd6ff17320 (diff) | |
| download | numpy-a413620ed8c13efc1f513859e3140ad6922d67d0.tar.gz | |
DOC: fixes from review
Diffstat (limited to 'doc/source/reference/random/legacy.rst')
| -rw-r--r-- | doc/source/reference/random/legacy.rst | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/doc/source/reference/random/legacy.rst b/doc/source/reference/random/legacy.rst index 9118fc052..922d76a9a 100644 --- a/doc/source/reference/random/legacy.rst +++ b/doc/source/reference/random/legacy.rst @@ -122,10 +122,18 @@ Distributions ~RandomState.weibull ~RandomState.zipf -Toplevel `numpy.random` functions -================================= -Many of the RandomState methods above are exported as top-level `numpy.random` -functions. These are: +Functions in `numpy.random` +=========================== +Many of the RandomState methods above are exported as functions in +`numpy.random` This usage is discouraged, as it is implemented via a gloabl +`RandomState` instance which is not advised on two counts: + +- It uses global state, which means results will change as the code changes + +- It uses a `RandomState` rather than the more modern `Generator`. + +For backward compatible legacy reasons, we cannot change this. See +`random-quick-start`. .. autosummary:: :toctree: generated/ |