The text and code are released under the CC0 license; see also the companion project, the Python Data Science Handbook.
Often an important piece of data analysis is repeating a similar calculation, over and over, in an automated fashion.
For example, you may have a table of a names that you'd like to split into first and last, or perhaps of dates that you'd like to convert to some standard format.
One of Python's answers to this is the iterator syntax.
We've seen this already with the range iterator:
In [1]:
for i in range(10):
print(i, end=' ')
Here we're going to dig a bit deeper.
It turns out that in Python 3, range is not a list, but is something called an iterator, and learning how it works is key to understanding a wide class of very useful Python functionality.
In [2]:
for value in [2, 4, 6, 8, 10]:
# do some operation
print(value + 1, end=' ')
The familiar "for x in y" syntax allows us to repeat some operation for each value in the list.
The fact that the syntax of the code is so close to its English description ("for [each] value in [the] list") is just one of the syntactic choices that makes Python such an intuitive language to learn and use.
But the face-value behavior is not what's really happening.
When you write something like "for val in L", the Python interpreter checks whether it has an iterator interface, which you can check yourself with the built-in iter function:
In [3]:
iter([2, 4, 6, 8, 10])
Out[3]:
It is this iterator object that provides the functionality required by the for loop.
The iter object is a container that gives you access to the next object for as long as it's valid, which can be seen with the built-in function next:
In [4]:
I = iter([2, 4, 6, 8, 10])
In [5]:
print(next(I))
In [6]:
print(next(I))
In [7]:
print(next(I))
What is the purpose of this level of indirection? Well, it turns out this is incredibly useful, because it allows Python to treat things as lists that are not actually lists.
In [8]:
range(10)
Out[8]:
range, like a list, exposes an iterator:
In [9]:
iter(range(10))
Out[9]:
So Python knows to treat it as if it's a list:
In [10]:
for i in range(10):
print(i, end=' ')
The benefit of the iterator indirection is that the full list is never explicitly created!
We can see this by doing a range calculation that would overwhelm our system memory if we actually instantiated it (note that in Python 2, range creates a list, so running the following will not lead to good things!):
In [11]:
N = 10 ** 12
for i in range(N):
if i >= 10: break
print(i, end=', ')
If range were to actually create that list of one trillion values, it would occupy tens of terabytes of machine memory: a waste, given the fact that we're ignoring all but the first 10 values!
In fact, there's no reason that iterators ever have to end at all!
Python's itertools library contains a count function that acts as an infinite range:
In [12]:
from itertools import count
for i in count():
if i >= 10:
break
print(i, end=', ')
Had we not thrown-in a loop break here, it would go on happily counting until the process is manually interrupted or killed (using, for example, ctrl-C).
In [13]:
L = [2, 4, 6, 8, 10]
for i in range(len(L)):
print(i, L[i])
Although this does work, Python provides a cleaner syntax using the enumerate iterator:
In [14]:
for i, val in enumerate(L):
print(i, val)
This is the more "Pythonic" way to enumerate the indices and values in a list.
In [15]:
L = [2, 4, 6, 8, 10]
R = [3, 6, 9, 12, 15]
for lval, rval in zip(L, R):
print(lval, rval)
Any number of iterables can be zipped together, and if they are different lengths, the shortest will determine the length of the zip.
In [16]:
# find the first 10 square numbers
square = lambda x: x ** 2
for val in map(square, range(10)):
print(val, end=' ')
The filter iterator looks similar, except it only passes-through values for which the filter function evaluates to True:
In [17]:
# find values up to 10 for which x % 2 is zero
is_even = lambda x: x % 2 == 0
for val in filter(is_even, range(10)):
print(val, end=' ')
The map and filter functions, along with the reduce function (which lives in Python's functools module) are fundamental components of the functional programming style, which, while not a dominant programming style in the Python world, has its outspoken proponents (see, for example, the pytoolz library).
We saw in *args and **kwargs: Flexible Arguments. that *args and **kwargs can be used to pass sequences and dictionaries to functions.
It turns out that the *args syntax works not just with sequences, but with any iterator:
In [18]:
print(*range(10))
So, for example, we can get tricky and compress the map example from before into the following:
In [19]:
print(*map(lambda x: x ** 2, range(10)))
Using this trick lets us answer the age-old question that comes up in Python learners' forums: why is there no unzip() function which does the opposite of zip()?
If you lock yourself in a dark closet and think about it for a while, you might realize that the opposite of zip() is... zip()! The key is that zip() can zip-together any number of iterators or sequences. Observe:
In [20]:
L1 = (1, 2, 3, 4)
L2 = ('a', 'b', 'c', 'd')
In [21]:
z = zip(L1, L2)
print(*z)
In [22]:
z = zip(L1, L2)
new_L1, new_L2 = zip(*z)
print(new_L1, new_L2)
Ponder this for a while. If you understand why it works, you'll have come a long way in understanding Python iterators!
itertoolsWe briefly looked at the infinite range iterator, itertools.count.
The itertools module contains a whole host of useful iterators; it's well worth your while to explore the module to see what's available.
As an example, consider the itertools.permutations function, which iterates over all permutations of a sequence:
In [23]:
from itertools import permutations
p = permutations(range(3))
print(*p)
Similarly, the itertools.combinations function iterates over all unique combinations of N values within a list:
In [24]:
from itertools import combinations
c = combinations(range(4), 2)
print(*c)
Somewhat related is the product iterator, which iterates over all sets of pairs between two or more iterables:
In [25]:
from itertools import product
p = product('ab', range(3))
print(*p)
Many more useful iterators exist in itertools: the full list can be found, along with some examples, in Python's online documentation.