The purpose of this lab is to:

- Review recursion, reading files, and other past topics
- Have fun!

Before you begin, please create a folder called `lab08` inside your `cs150` folder. This is where you should put all files made for this lab.

This lab has 3 parts. Completing one part successfully leads you the next, so only part 1 is available to you initially. If you don't make it through all the parts, do a handin with the programs you did complete.

As a reminder, our six-step process for creating programs is as follows:

**Describe:** Specify the problem you're trying to solve, as precisely as possible.

**Understand:** Work through some examples. This should help build intuition about the problem and hopefully suggest approaches to solving it. You may discover your description of the problem from the previous step wasn't sufficiently precise.

**Design:** Try to formalize the process you used to solve the examples above by writing it in pseudocode. Think about whether this matches up with what you were actually doing. Does it generate the same answers? Can you think of cases in which your solution might not work? Spend some time thinking about how to break the code into logical functions (and later object) to make your code more readable and managable.

**Implement:** Translate your pseudocode into real code. Note that this is the first step that actually has you programming. Don't try to implement everything at once. Find the core function and get that working. Then add additional features and functionality.

**Test:** Check your program on the cases you worked by hand. Check it on larger cases. And test the components of your program as well -- as you program, test that the functions you've created behave as you expect. Debugging and testing in a piecewise fashion is far easier than chasing down errors in a large program where all your code is suspect.

**Maintain:** Clean up your code and comment appropriately. Typically in the course of writing a program, you'll add sloppy code just for the sake of testing other components. That's fine, just get in the habit of fixing these pieces before you forget what they were doing. And look for places you can tidy things up by making a more general function, removing unneccessary variables, making your variable names correspond to their meaning, removing debugging code, and adding comments.

As this course moves forward, the labs will become progressively less and less explicit about these steps. That doesn't mean you're now free to forget about them! Your job is to figure out what makes sense for each of these steps yourself.

The Syracuse problem (also known variously as the 3x+1 problem, the Collatz Conjecture, or Kakutani's problem) concerns a strange collection of sequences. For every positive integer, there is a Syracuse sequence. For example, Syracuse sequence 17 is

Can you see the pattern?

The Syracuse sequence for the number x is created by recursively applying a certain function f to x which depends on the parity of x. In particular, f(x) = 3x+1 if x is odd, and f(x) = x//2 if x is even. Once you get to 1, you stop (you could keep going, but at this point we'd just cycle between 4, 2 and 1, so generally we stop the sequence at 1). As another example, Syracuse sequence 14 looks like

Note that once we reach 17, the pattern is the same as the previous one. No one knows whether all Syracuse sequences eventually reach 1. In other words, it is possible that for some starting numbers, the corresponding Syracuse sequences never get to 1. However, mathematicians have checked a few numbers, and at least the first quintillion (10^{18}) of them do make it to 1 eventually.

Write a program called `syracuse.py`. This contains a recursive function `rec(x)` that takes in an integer `x` and returns an integer indicating the number of elements in the Syracuse sequence that begins with x (counting the starting number `x` and the final number 1). So `rec(4)` should return 3, `rec(17)` should return 13, and `rec(28)` should return 19.

*Important:* The function `rec` may only take in a single integer and may only return a single integer. Do NOT use global variables (variables accessible in any function body). Do NOT use loops within `rec`. Hint: You need to count the number of times you generate a number in the sequence - this will probably be the same as the number of recursive calls your program makes, plus 1 for the base case.

Your syracuse.py program should begin by prompting the user for a sequence *length* (a positive integer). Using a while loop and your `rec` function, find the smallest starting integer x such that Syracuse sequence x has at least the requested length. For example, the first 10 Syracuse sequences have lengths

Starting Value | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 |
---|---|---|---|---|---|---|---|---|---|---|

Sequence Length | 1 | 2 | 8 | 3 | 6 | 9 | 17 | 4 | 20 | 7 |

So if the user entered 6, your program should print 3: the third Syracuse sequence is the first to have length at least 6. Were the user to enter 15, your program should print 7, since all Syracuse sequences from one to six have lengths less than 15, while Syracuse sequence 7 has a length at least 15.

Now, use your program to find the smallest integer x whose Syracuse sequence contains at least 500 numbers. In the lab url, replace the second occurence of "lab07" in the above url with the value of x to get to the next stage. For example, if the correct answer was 12345 (it isn't), you'd go to

`http://www.cs.oberlin.edu/~bob/cs150/Labs/lab08/12345.html`

As usual, you'll want to do a handin after each part of this lab, so refer back here as you finish subsequent parts.

If you followed the Honor Code in this assignment,include a README file with the text:

I affirm that I have adhered to the Honor Code in this assignment.

You now just need to electronically handin all your files. As a reminder

% cd # changes to your home directory % cd cs150 # goes to your cs150 folder % handin # starts the handin program # class is 150 # assignment is 8 # file/directory is lab08 % lshand # should show that you've handed in something

You can also specify the options to handin from the command line

% cd ~/cs150 # goes to your cs150 folder % handin -c 150 -a 8 lab08