What does the Ellipsis object do?

This came up in another question recently. I’ll elaborate on my answer from there:

Ellipsis is an object that can appear in slice notation. For example:

myList[1:2, ..., 0]

Its interpretation is purely up to whatever implements the __getitem__ function and sees Ellipsis objects there, but its main (and intended) use is in the numpy third-party library, which adds a multidimensional array type. Since there are more than one dimensions, slicing becomes more complex than just a start and stop index; it is useful to be able to slice in multiple dimensions as well. E.g., given a 4×4 array, the top left area would be defined by the slice [:2,:2]:

>>> a
array([[ 1,  2,  3,  4],
       [ 5,  6,  7,  8],
       [ 9, 10, 11, 12],
       [13, 14, 15, 16]])

>>> a[:2,:2]  # top left
array([[1, 2],
       [5, 6]])

Extending this further, Ellipsis is used here to indicate a placeholder for the rest of the array dimensions not specified. Think of it as indicating the full slice [:] for all the dimensions in the gap it is placed, so for a 3d array, a[...,0] is the same as a[:,:,0] and for 4d, a[:,:,:,0], similarly, a[0,...,0] is a[0,:,:,0] (with however many colons in the middle make up the full number of dimensions in the array).

Interestingly, in python3, the Ellipsis literal (...) is usable outside the slice syntax, so you can actually write:

>>> ...
Ellipsis

Other than the various numeric types, no, I don’t think it’s used. As far as I’m aware, it was added purely for numpy use and has no core support other than providing the object and corresponding syntax. The object being there didn’t require this, but the literal “…” support for slices did.

Related Posts:

  1. What does enumerate() mean?
  2. Does Python have a ternary conditional operator?
  3. What is the difference between Python’s list methods append and extend?
  4. Iterating over dictionaries using ‘for’ loops
  5. how to sort pandas dataframe from one column
  6. Understanding slice notation
  7. How do I sort a dictionary by value?
  8. How do I sort a dictionary by value?
  9. How to iterate over rows in a DataFrame in Pandas
  10. How to convert list to string [duplicate]
  11. How to uninstall a package installed with pip install –user
  12. Save plot to image file instead of displaying it using Matplotlib
  13. ModuleNotFoundError: No module named ‘sklearn’
  14. Does Python have an ordered set?
  15. Asking the user for input until they give a valid response
  16. Print a list in reverse order with range()?
  17. Configuring so that pip install can work from github
  18. Proper way to declare custom exceptions in modern Python?
  19. TypeError: ‘float’ object not iterable
  20. write() versus writelines() and concatenated strings
  21. How can I get a list shape without using numpy?
  22. AttributeError: ‘str’ object has no attribute ‘append’
  23. python socket.error: [Errno 98] Address already in use
  24. How to read a .xlsx file using the pandas Library in iPython?
  25. Numpy/Python Array Value error
  26. Changing the “tick frequency” on x or y axis in matplotlib?
  27. TypeError: unsupported operand type(s) for -: ‘str’ and ‘str’
  28. Remove all special characters, punctuation and spaces from string
  29. AttributeError: ” object has no attribute ”
  30. Plot pie chart and table of pandas dataframe
  31. ModuleNotFoundError: No module named ‘matplotlib’
  32. “inconsistent use of tabs and spaces in indentation”
  33. Pandas ‘count(distinct)’ equivalent
  34. Python [Errno 98] Address already in use
  35. How do you call an instance of a class in Python?
  36. Flask ImportError: No Module Named Flask
  37. How do you use subprocess.check_output() in Python?
  38. ImportError: libcuda.so.1: cannot open shared object file
  39. TypeError: list indices must be integers or slices, not str
  40. python object() takes no parameters error
  41. How do I find the distance between two points?
  42. How do I calculate percentiles with python/numpy?
  43. How do I remove a substring from the end of a string?
  44. Selecting with complex criteria from pandas.DataFrame
  45. How can I download Anaconda for python 3.6
  46. django:django.core.exceptions.AppRegistryNotReady: Apps aren’t loaded yet
  47. Pointers in Python?
  48. Django – no such table exception
  49. How to make a histogram from a list of data
  50. Using __add__ operator with multiple arguments in Python
  51. How to constantly run Python script in the background on Windows?
  52. Django – “no module named django.core.management”
  53. Python List object attribute ‘append’ is read-only
  54. Infinite for loops possible in Python?
  55. RuntimeError: module compiled against API version a but this version of numpy is 9
  56. Python3 Error: TypeError: Can’t convert ‘bytes’ object to str implicitly
  57. How to run Pip commands from CMD
  58. Sorting and Grouping Nested Lists in Python
  59. Python Subprocess: Too Many Open Files
  60. urllib2.HTTPError: HTTP Error 403: Forbidden
  61. .write not working in Python
  62. Install Plotly in Anaconda
  63. Compute a confidence interval from sample data
  64. Can’t get Python to import from a different folder
  65. How to crop an image in OpenCV using Python
  66. convert csv file to list of dictionaries
  67. What’s the difference between “virtualenv” and “-m venv” in creating Virtual environments(Python)
  68. OperationalError: database is locked
  69. Decode Hex String in Python 3
  70. Python ImportError: No module named wx
  71. Accessing a class’ member variables in Python?
  72. Declaring a multi dimensional dictionary in python
  73. How do I compute derivative using Numpy?
  74. No module named utils error on compiling py file
  75. Convert Pandas Column to DateTime
  76. ImportError: cannot import name NUMPY_MKL
  77. How to print a linebreak in a python function?
  78. Pandas dataframe groupby plot
  79. Download Returned Zip file from URL
  80. Python 3 TypeError: must be str, not bytes with sys.stdout.write()
  81. tkinter gui layout using frames and grid
  82. inverting image in Python with OpenCV
  83. Meaning of list[-1] in Python
  84. Tkinter error: Couldn’t recognize data in image file
  85. How to install Openpyxl with pip
  86. getting ZeroDivisionError: integer division or modulo by zero
  87. Iterating through list of list in Python
  88. Installing scipy for python 2.7
  89. ValueError: Cannot set a frame with no defined index and a value that cannot be converted to a Series
  90. SMTP AUTH extension not supported by server
  91. How to install PyQt4 on Windows using pip?
  92. How to install PyQt4 on Windows using pip?
  93. python dictionary error AttributeError: ‘list’ object has no attribute ‘keys’
  94. What is a mixin, and why are they useful?
  95. What is the most efficient way to store a list in the Django models?
  96. Convert list of dictionaries to a pandas DataFrame
  97. How to read html from a url in python 3
  98. Set variable in jinja
  99. Python how to write to a binary file?
  100. How to download a file via FTP with Python ftplib

Leave a Comment