Grid Reference

The Grid class in grid.py provides a simple 2-d storage utility. The values stored can be any Python value.

Grid(width, height) - constructs new grid. Initially all locations are None

grid.width, grid.height - width/height properties

grid.get(x, y) - returns contents at x,y (error if x,y out of bounds)

grid.set(x, y, val) - sets value into the grid at x,y (error if x,y out of bounds)

grid.in_bounds(x, y) - returns True if the x,y is in bounds of the grid. False otherwise.

build(lst) - constructs a new grid based on a nested-list format like this

# e.g. this makes a 3 by 2 grid:
grid = Grid.build([[1, 2, 3], [4, 5 6]])
# [1, 2, 3] is row y = 0
# [4, 5, 6] is row y = 1

Grid Demo

def grid_demo():
    """
    Demonstrate use of the Grid class.
    """
    # Create width 4 by height 2 grid, filled with None initially.
    grid = Grid(4, 2)

    # loop over contents in usual way,
    # setting every location to 6
    for y in range(grid.height):
        for x in range(grid.width):
            grid.set(x, y, 6)


    # access 0,0
    val = grid.get(0, 0)

    # verify that 3,1 is in bounds
    if grid.in_bounds(3, 1):
        # set 3,1
        grid.set(3, 1, 11)

    print(grid)
    # print uses nested-list format
    # showing row-0, then row-1
    # [[6, 6, 6, 6], [6, 6, 6, 11]]

    # Grid.build() also uses nested-list format, allowing
    # you to construct a grid on the fly.
    grid2 = Grid.build([[6, 6, 6, 6], [6, 6, 6, 11]])