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
and the PR is
The new method (as it would be called from Python) is
permuted(x, axis=None, out=None)
The CircleCI rendering of the docstring from the pull request is
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:
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).