[Numpy-discussion] Re: NumPy Development Meeting Wednesday - Triage Focus

2021-10-14 Thread timdavid312
Relevant post thanks for sharing. https://ironmongerysolutions.co.uk/ ___ NumPy-Discussion mailing list -- numpy-discussion@python.org To unsubscribe send an email to numpy-discussion-le...@python.org https://mail.python.org/mailman3/lists/numpy-discussio

[Numpy-discussion] What happened to the numpy.random documentation?

2021-10-14 Thread Paul M.
Hi All, The documentation of Numpy's submodules used to have a fairly standard structure as shown here in the 1.16 documentation: https://docs.scipy.org/doc/numpy-1.16.1/reference/routines.random.html Now the same page in the API documentation looks like this: https://numpy.org/doc/stable/

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Melissa Mendonça
Hi Paul, Do you think having a page with the flat list of routines back, in addition to the explanations, would solve this? - Melissa On Thu, Oct 14, 2021 at 1:34 PM Paul M. wrote: > Hi All, > > The documentation of Numpy's submodules used to have a fairly standard > structure as shown here i

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Joseph Fox-Rabinovitz
I second that reinstating such a list would be extremely useful. My issue has been with the polynomial package, but the end result is the same. - Joe On Thu, Oct 14, 2021, 12:45 Melissa Mendonça wrote: > Hi Paul, > > Do you think having a page with the flat list of routines back, in > addition

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Paul M.
Hi Melissa, I think that's the right approach. Looking through the current docs, I think the page on the FFT module is exemplary in this regard: https://numpy.org/doc/stable/reference/routines.fft.html It lists all the available functions (with links to details), and then has a section on "Back

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Kevin Sheppard
I think the issue in random specifically is that a raw list of available functions does not provide suitable guidance for someone looking for random variate generating function. This is because the module-level API is mostly dominated by methods of the singleton RandomState instance. Best practice

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Paul M.
Hi Kevin, I'm all for wanting the docs to guide folks to current best practice, but in its current form the documentation for this module is quite opaque. Maybe a table like the old version that maps old functionality to exemplar versions using Generator instances would be a useful compromise? C

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Andras Deak
On Thursday, October 14, 2021, Joseph Fox-Rabinovitz < jfoxrabinov...@gmail.com> wrote: > I second that reinstating such a list would be extremely useful. My issue > has been with the polynomial package, but the end result is the same. > There's a mostly relevant issue: https://github.com/numpy/n

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Ralf Gommers
On Thu, Oct 14, 2021 at 7:19 PM Kevin Sheppard wrote: > I think the issue in random specifically is that a raw list of > available functions does not provide suitable guidance for someone looking > for random variate generating function. This is because the module-level > API is mostly dominated

[Numpy-discussion] Re: What happened to the numpy.random documentation?

2021-10-14 Thread Charles R Harris
On Thu, Oct 14, 2021 at 10:36 AM Paul M. wrote: > Hi All, > > The documentation of Numpy's submodules used to have a fairly standard > structure as shown here in the 1.16 documentation: > > https://docs.scipy.org/doc/numpy-1.16.1/reference/routines.random.html > > Now the same page in the API