Comment utiliser la syntaxe de découpage en ellipses en Python ?

Question

C'est apparu dans Fonctions cachées de Python mais je ne vois pas de bonne documentation ou d'exemples qui expliquent le fonctionnement de cette fonctionnalité.

Answer 1

L'ellipse est utilisée dans numpy pour découper les structures de données à haute dimension.

Il est conçu pour signifier à ce stade, insérez autant de tranches complètes ( : ) pour étendre la tranche multidimensionnelle à toutes les dimensions .

Exemple :

>>> from numpy import arange
>>> a = arange(16).reshape(2,2,2,2)

Maintenant, vous avez une matrice à 4 dimensions d'ordre 2x2x2x2. Pour sélectionner tous les premiers éléments dans la 4e dimension, vous pouvez utiliser la notation de l'ellipse

>>> a[..., 0].flatten()
array([ 0,  2,  4,  6,  8, 10, 12, 14])

ce qui est équivalent à

>>> a[:,:,:,0].flatten()
array([ 0,  2,  4,  6,  8, 10, 12, 14])

Dans vos propres implémentations, vous êtes libre d'ignorer le contrat mentionné ci-dessus et de l'utiliser comme bon vous semble.

Answer 2

Ellipsis ou ... n'est pas une fonctionnalité cachée, c'est juste une constante. C'est très différent de, disons, javascript ES6 où il fait partie de la syntaxe du langage. Aucune classe intégrée ou constante du langage Python ne l'utilise.

La syntaxe dépend donc entièrement de vous, ou de quelqu'un d'autre, qui a écrit du code pour la comprendre.

Numpy l'utilise, comme indiqué dans le documentation . Quelques exemples ici .

Dans votre propre classe, vous l'utiliseriez comme ceci :

>>> class TestEllipsis(object):
...     def __getitem__(self, item):
...         if item is Ellipsis:
...             return "Returning all items"
...         else:
...             return "return %r items" % item
... 
>>> x = TestEllipsis()
>>> print x[2]
return 2 items
>>> print x[...]
Returning all items

Bien sûr, il y a le documentation python et référence linguistique . Mais ils ne sont pas très utiles.

Answer 3

C'est une autre utilisation de l'ellipse, qui n'a rien à voir avec les tranches : Je l'utilise souvent dans la communication intra-thread avec les files d'attente, comme une marque qui signale "Done" ; il est là, c'est un objet, c'est un singleton, et son nom signifie "absence de", et ce n'est pas le None surutilisé (qui pourrait être mis dans une file d'attente dans le cadre du flux de données normal). YMMV.

Answer 4

Comme indiqué dans d'autres réponses, il peut être utilisé pour créer des tranches. Utile lorsque vous ne voulez pas écrire beaucoup de notations de tranches complètes ( : ), ou lorsque vous n'êtes tout simplement pas sûr de la dimensionnalité du tableau à manipuler.

Ce qui me semblait important de souligner, et qui manquait dans les autres réponses, c'est qu'il peut être utilisé même lorsqu'il n'y a plus de dimensions à remplir.

Exemple :

>>> from numpy import arange
>>> a = arange(4).reshape(2,2)

Cela entraînera une erreur :

>>> a[:,0,:]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
IndexError: too many indices for array

Ça va marcher :

a[...,0,:]
array([0, 1])

Answer 5

La documentation de Python n'est pas très claire à ce sujet, mais il existe une autre utilisation de l'ellipse. Elle est utilisée comme représentation de structures de données infinies dans le cas de Python. Cette question discute du comment et de quelques applications réelles.