On Mon, 2020-08-03 at 14:09 -0400, Warren Weckesser wrote:
In one of the previous weekly zoom meetings, it was suggested to ping the mailing list about an updated PR that implements the `permuted` method for the Generator class in numpy.random. The relevant issue is
https://github.com/numpy/numpy/issues/5173
and the PR is
https://github.com/numpy/numpy/pull/15121
The new method (as it would be called from Python) is
permuted(x, axis=None, out=None)
I like the proposed API and name personally, and think we should go ahead with it. It is a useful complement to `shuffle` (and sorting). The followup questions of adding `shuffled`, and what to do about `permutation` are important, but I agree with viewing them as a second step. This API has been discussed a few times in various depths, so I assume that `permuted` as a name and API has largely settle down, and reached consensus (at last if there is not more activity here or on the PR). So, as a heads up, I am planning to review and push that forward in the next days, but more discussion is of course welcome. We still have time to decide differently. Cheers, Sebastian
The CircleCI rendering of the docstring from the pull request is
https://14745-908607-gh.circle-artifacts.com/0/doc/build/html/reference/rand...
The new method is an alternative to the existing `shuffle` and `permutation` methods. It handles the `axis` parameter similar to how the sort methods do, i.e. when `axis` is given, the slices along the axis are shuffled independently. This new documentation (added as part of the pull request) explains the API of the various related methods:
https://14745-908607-gh.circle-artifacts.com/0/doc/build/html/reference/rand...
Additional feedback on the implementation of `permuted` in the pull request is welcome. Further discussion of the API should be held in the issue gh-5173 (but please familiarize yourself with the discussion of the API in gh-5173--there has already been quite a long discussion of several different APIs).
Thanks,
Warren _______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@python.org https://mail.python.org/mailman/listinfo/numpy-discussion