<< Back to PYTHON
Python 2D List ExamplesCreate a list of lists, or a 2D list. Append empty lists to a list and add elements.
2D list. On a flat stone surface, we play a game of marbles. There is red, aquamarine, indigo. No marble is on top of another. The game is limited to 2 dimensions—just X and Y positions.
Think now of a Python list. In it we can place other lists. This creates a 2D representation of objects (like glass marbles). We can access elements on each list with an index.
First example. We create an empty list and add empty lists to it with append(). We can construct any rectangular (or jagged) list this way. In this example we build a 2 by 2 list.
Step 1: We first create an empty list with the empty square brackets. Then we call the append method and add 2 empty lists.List
Step 2: We access each sub-list and call append on it. This appends to the inner lists.
Step 3: We display the element at indexes 0, 0 and this value is 1. With the print() method we can display the entire list contents.
Step 4: This loop can iterate rows and columns in the 2D list. Nested for-loops loop over rows and columns.for
Python program that uses 2D list
# Step 1: create a list.
# ... Append empty lists in first two indexes.
elements = 
# Step 2: add elements to empty lists.
# Step 3: display top-left element.
# ... Display entire list.
# Step 4: loop over rows.
for row in elements:
# Loop over columns.
for column in row:
[[1, 2], [3, 4]]
Jagged lists. The term "jagged" implies that sub lists have uneven lengths. Here we create a list of 2 lists—one of length 2, the other of length 5. We display their lengths.
Info: This is a list of lists, not exactly a 2D list. It does not need to be rectangular—some lists can be longer than others.
Tip: All the methods on list, including "len" and "in," work on nested lists. But they consider only one sub-list at a time.Len
Caution: For performance, nested lists are not optimal. An array is faster than a list.Array
Python program that uses jagged lists
# A jagged list.
values = [[10, 20], [30, 40, 50, 60, 70]]
for value in values:
# Print each row's length and its elements.
2 [10, 20]
5 [30, 40, 50, 60, 70]
Flattened. It is possible to index into a flat array as though it is two-dimensional. We add the first coordinate, "x," and then multiply the second "y" coordinate by the length.
Index: The multiplication of the coordinates returns a single integer for a 2D point.
Here: We define get_element and set_element methods. We compute indexes based on an "x" and "y" coordinate pair.
Python program that uses flattened list
def get_element(elements, x, y):
# Get element with two coordinates.
return elements[x + (y * 10)]
def set_element(elements, x, y, value):
# Set element with two coordinates.
elements[x + (y * 10)] = value
# Create a list of 100 elements.
elements = 
for i in range(0, 100):
i = 0
for x in range(0, 10):
for y in range(0, 10):
# Set each element in the list to an incremented number.
set_element(elements, x, y, i)
i += 1
# First in first row.
print(get_element(elements, 0, 0))
# Last in first row.
print(get_element(elements, 0, 9))
# First in last row.
print(get_element(elements, 9, 0))
# Last in last row.
print(get_element(elements, 9, 9))
Benchmark, nested list. Suppose it is simple to change a nested list to a flattened, 1D list. This will likely result in a performance increase.
Version 1: This version of the code accesses an element in a nested list—so it accesses 2 elements total.
Version 2: This code accesses the flattened list, using an expression to compute the correct index.
Result: Accessing the element at position coordinates 1, 2 is slightly faster in the flattened list.
Python program that times nested, flattened list
# Nested, 3x2.
nested_list = 
nested_list.append([10, 20, 30])
nested_list.append([40, 50, 60])
# Flattened, 3x2.
flat_list = [10, 20, 30, 40, 50, 60]
# Test the two lists.
print(flat_list[1 + (2 * 2)])
# Version 1: access element in nested list.
for i in range(0, 100000000):
if nested_list != 60:
# Version 2: access element in flattened list.
for i in range(0, 100000000):
if flat_list[1 + (2 * 2)] != 60:
1420077375.334: Nested list, 0.539 s
1420077375.794: Flat list, 0.460 s [PyPy]
2D array. Python supports a special "array" from the array module. An integer array is more compact in memory than an integer list. We can create a flattened 2D array.2D Array
Usage. Sometimes a 2D list is helpful in programs. For a simple or small coordinate system or grid, nested lists can be useful. They are flexible. The syntax is clear.
Larger data sizes. For larger or more complex requirements, this approach is not ideal. Another data structure, like an array, is a better choice at this scale.