CS21 HW10: A fire simulator

Due 11:59pm Tuesday, December 4, 2007
You should save your program for this assignment in cs21/homework/10. A skeleton version of the program will appear in this directory when you run update21 in a terminal window. The program handin21 will only submit files in this directory. You may work with a partner on this assignment.

Some of the problems will have optional components that allow you to further practice your skills in Python. Optional portions will not be graded, but may be interesting for those wanting some extra challenges.

This assignment asks you to use object oriented design to simulate the spread of a forest fire. Your simulation will use the terrain class which we wrote for this assignment. The terrain class models a forest as a rectangular grid of r rows and c columns. Each cell in the grid is in one of three possible states:

  1. Forest (not-burning)
  2. Burning Forest
  3. Empty (previously burnt or cleared)
The colors green, red, and black represent forest, burning forest, and empty space, respectively.

Examine the methods in the terrain class by opening an IDLE shell, importing the terrain module using import terrain and running help(terrain). The sample code below shows how the methods might be used.

from terrain import *

t = terrain(10, 12)
t.setEmpty(3,3)
t.setBurning(1,2)
t.update()
t.close()
The resulting terrain is shown below. Note that cell in location (0,0) in in the lower left corner.

Modeling the spread of fire
Modify the file fireSim.py in your cs21/homework/10 folder to implement a class fireSim that models the spread of fire across a terrain. We will use a simple probabilistic model to simulate the spread of fire. The simulation will proceed in a number of steps. In each step, we look at each cell in the terrain and update its status based on the cell's current status and the status of its neighbors. For this simulation, the neighbors of a cell are cells that are to the immediate North, South, East, or West of the given cell. If the cell is located at position (i,j), the location and names of the neighbors are depicted below.

The basic rules for updating the status each cell is as follows.

The probability of burning is a parameter that can be set by the user depending on conditions, such as forest coverage type, or wet/dry weather conditions.

The image below shows the status of a fire after 10 steps

Simulator Requirements
Your simulation class should create a new fire simulator given the initial dimensions of the terrain and a probability of catching fire. Your simulator must have the following features: A sample main function may look like this:
def main():
  f = fireSim(10, 12, .55)
  f.startFire(5,6)
  f.spread()
  print "This fire burned %0.2f%% of the terrain in %d steps" \
       % (f.percentBurned(), f.numSteps())
  f.close()
A sample run of this function would print: This fire burned 69.17% of the terrain in 18 steps. You may have different method names with different parameters. The design is up to you as long as you implement all the requirements.
Testing
Be sure to test your class by creating some terrains with different sizes, changing the probability of burning, or starting fires in different locations.
Hints and Tips
Here are a few Hints and Tips that might help avoid potential problems.
Optional Components
As noted above, these questions are NOT required to receive full credit. Furthermore, do not attempt to solve these problems until the required portion of the assignment is complete.

There are many extensions you could add to this program. You could modify how the fire spreads by adding additional rules or parameters. For example, perhaps the probability of catching on fire depends on the number of neighboring trees that are on fire. Perhaps you can add a wind direction and modify the probabilities such that trees down-wind of an active fire are more likely to burn. Perhaps you can create an initial grid with a few "fire lines" of empty cells to prevent fires from spreading. Add a feature where cells could randomly start burning even if no neighbors are burning (as happens with lightning). Allow fire to spread to cells that are more than one cell away. If you allow this feature, can you get a fire to jump a fire line? More complex models could factor in topography, soil moisture, smoldering fires, etc., and are actually used in some geographical information system (GIS) applications for predicting and modeling forest fire risk.

Submit

Once you are satisfied with your program, hand it in by typing handin21 in a terminal window.

Acknowledgements
The idea for this assignment came from a 2007 SIGCSE Nifty Assignment presented by Angela B. Shiflet of Wofford College.