On 1/16/2013 11:41 PM, Nathaniel Smith wrote:

On 16 Jan 2013 17:54, <josef.pktd@gmail.com> wrote:
> >>> a = np.random.random_integers(0, 5, size=5)
> >>> b = a.sort()
> >>> b
> >>> a
> array([0, 1, 2, 5, 5])
>
> >>> b = np.random.shuffle(a)
> >>> b
> >>> b = np.random.permutation(a)
> >>> b
> array([0, 5, 5, 2, 1])
>
> How do I remember if shuffle shuffles or permutes ?
>
> Do we have a list of functions that are inplace?

I rather like the convention used elsewhere in Python of naming in-place operations with present tense imperative verbs, and out-of-place operations with past participles. So you have sort/sorted, reverse/reversed, etc.

Here this would suggest we name these two operations as either shuffle() and shuffled(), or permute() and permuted().

I like this (tense) suggestion.  It seems easy to remember.  --jv