CSCI 4500/6500 Programming Languages Project 3: Scheme LSystem Fractals 

Assigned: Tuesday January 31, 2006 Due: Tuesday Febrary 14, 2006 
Collaboration Policy  Read Carefully
You must work on this project individually, but you may discuss this assignment with other students in the class and ask and provide help in useful ways, preferable over our email list so we can all benefit from your great ideas. You may consult any outside resources you wish including books, papers, web sites and people (but no penguins or sea urchins).
If you use resources other than the class materials, indicate what you used along with your answer.
Purpose
Another objective for this assignment, is ofcourse for you to familiarize yourself with a functional language, i.e. scheme and what it entails (e.g. highlevel functions). You should use DrScheme, environment to develop your first functional langauage program. Here are some suggestions on getting DrScheme.

Download: Download project3.zip
to your machine and unzip it.
This file contains:

we recommend you start early. 
In this problem set, you will explore a method of creating fractals known as the Lindenmayer system (or Lsystem). Aristid Lindemayer, a theoretical biologist at the University of Utrecht, developed the Lsystem in 1968 as a mathematical theory of plant development. In the late 1980s, he collaborated with Przemyslaw Prusinkiewicz, a computer scientist at the University of Regina, to explore computational properties of the Lsystem and developed many of the ideas on which this problem set is based.
The idea behind Lsystem fractals is that we can describe a curve as a list of lines and turns, and create new curves by rewriting old curves. Everything in an Lsystem curve is either a forward line (denoted by F), or a right turn (denoted by Ra where a is an angle in degrees clockwise). We can denote left turns by using negative angles.
We create fractals by recursively replacing all forward lines in a curve list with the original curve list. Lindemayer found that many objects in nature could be described using regularly repeating patterns. For example, the way some tree branches sprout from a trunch can be described using the pattern: F O(R30 F) F O(R60 F) F. This is interpreted as: the trunk goes up one unit distance, a branch sprouts at an angle 30 degrees to the trunk and grows for one unit. The O means an offshoot — we draw the curve in the following parentheses, and then return to where we started before the offshoot. The trunk grows another unit and now another branch, this time at 60 degrees relative to the trunk grows for one units. Finally the trunk grows for one more unit. The branches continue to sprout in this manner as they get smaller and smaller, and eventually we reach the leaves.
We can describe this process using replacement rules:
Start: (F)Here are the commands this produces after two iterations:
Rule: F ::= (F O(R30 F) F O(R60 F) F)
Iteration 0: (F)
Iteration 1: (F O(R30 F) F O(R60 F) F)
Iteration 2: (F O(R30 F) F O(R60 F) F O(R30 F O(R30 F) F O(R60 F) F) F O(R30 F) F O(R60 F) F O(R60 F O(R30 F) F O(R60 F) F) F O(R30 F) F O(R60 F) F)
Here's what that looks like:
Iteration 0 
Iteration 1 
Iteration 2 
Iteration 5 
The Great Lambda Tree of Infinite Knowledge and Ultimate Power 
Note that Lsystem command rewriting is similar to the replacement rules in a BNF grammar. The important difference is that with Lsystem rewriting, each iteration replaces all instances of F in the initial string instead of just picking one to replace.
We can divide the problem of producing an Lsystem fractal into two main parts:
Here is a BNF grammar for Lsystem commands:
 CommandSequence ::= ( CommandList )
 CommandList ::= Command CommandList
 CommandList ::=
 Command ::= F
 Command ::= RAngle
 Command ::= OCommandSequence
 Angle ::= Number
Question 1: Show that (F O(R60 F) F) is a string in the language defined by our BNF grammar. To do this, you should start with CommandSequence, and show a sequence of replacements that follow the grammar rules that produce the target string. You can use the rule numbers above to identify the rules. 
We need to find a way to turn strings in this grammar into objects we can manipulate in a Scheme program. We can do this by looking at the BNF grammar, and converting the nonterminals into Scheme objects.
;;; CommandSequence ::= ( CommandList ) (define makelsystemcommand list) ;;; We represent the different commands as pairs where the first item in the ;;; pair is a tag that indicates the type of command: 'f for forward, 'r for ;;; rotate and 'o for offshoot. We use quoted letters to make tags, which ;;; evaluate to the quoted letter. The tag 'f is short for (quote f). ;;; Command ::= F (define (makeforwardcommand) (cons 'f #f)) ;; No value, just use false. ;;; Command ::= RAngle (define (makerotatecommand angle) (cons 'r angle)) ;;; Command ::= OCommandSequence (define (makeoffshootcommand commandsequence) (cons 'o commandsequence))
Question 2: It will be useful to have procedures
that take Lsystem commands as parameters, and return information about
those commands. Define the following procedures in main.ss:

You will find the following procedures useful:
You should be able to make up similar test cases yourself to make sure the other procedures you defined work.> (isforward? (makeforwardcommand))
#t
> (isforward? (makerotatecommand 90))
#f
> (getangle (makerotatecommand 90))
90
> (getangle (makeforwardcommand))
Yikes! Attempt to getangle for a command that is not an angle command
Start: (F)To produce levels of the tree fractal, we need a procedure that takes a list of Lsystem commands and replaces each F command with the list of Lsystem commands given by the rule.
Rule: F ::= (F O(R30 F) F O(R60 F) F)
So, for every command in the list:
For example, consider a simple LSystem rewriting:
Start: (F)We want to get:
Rule: F ::= (F R30 F)
Iteration1: (F R30 F)but if we just replace F's with (F R30 F) lists, we would get:
Iteration2: (F R30 F R30 F R30 F)
Iteration1: ((F R30 F))The easiest way to fix this problem is to flatten the result. The code should look similar to many recursive list procedures you have seen (this code is provided in lsystem.ss):
Iteration2: ((F R30 F) R30 (F R30 F))
(define (flattencommands ll) (if (null? ll) ll (if (islsystemcommand? (car ll)) (cons (car ll) (flattencommands (cdr ll))) (flatappend (car ll) (flattencommands (cdr ll)))))) (define (flatappend lst ll) (if (null? lst) ll (cons (car lst) (flatappend (cdr lst) ll))))
Question 3: Define a procedure rewritelcommands
in main.ss that takes a list of Lsystem commands as its first parameter. The second
parameter is a list of Lsystem commands that should replace every forward
command in the first list of commands in the result.
Here's the easy part: Complete the definition of rewritelcommands.(define (rewritelcommands lcommands replacement) (flattencommands (map ; Procedure to apply to each command lcommands))) 
To make interesting Lsystem curves, we will need to apply rewritelcommands many times. We will leave that until the last question. Next, we will work on turning sequences of Lsystem commands into curves we can draw.
We will use a coordinate system from (0, 0) to (1, 1):
(0.0, 1.0)  (1.0, 1.0)  


(0.0, 0.0)  (1.0, 0.0) 
Points have x and y coordinates. To represent points we would like to define procedures makepoint, xofpoint and yofpoint. Our pictures will be more interesting if points can have color too. So, we represent a colored point using a list of three values: x, y and color:
Note that we have defined points so we can have both colored points and colorless points that appear black.(define (makepoint x y) (list x y)) (define (makecoloredpoint x y c) (list x y c)) (define (iscoloredpoint? (= (length point) 3) (define (xofpoint point) (car point)) (define (yofpoint point) (cadr point)) ;; (cadr x) = (car (cdr x)) ;;; Regular points are black. Colored points have a color. (define (colorofpoint point) (if (iscoloredpoint? point) (caddr point) ;; == (car (cdr (cdr point))) (makecolor 0 0 0)))
We have provided some procedures for drawing on the window in graphics.ss:
(define (midline t) (makepoint t 0.5))defines a curve that is a horizontal line across the middle of the window. If we apply midline to a value x, we get the point (x, 0.5). Hence, if we apply midline to all values between 0.0 and 1.0, we get a horizontal line.
Predict what (xofpoint (midline 0.7)) and (yofpoint (midline 0.7)) should evaluate to. Try them in your Interactions window.
Of course, there are infinitely many values between 0.0 and 1.0, so we can't apply the curve function to all of them. Instead, we select enough values to show the curve well. To draw a curve, we need to apply the curve procedure to many values in the range from 0.0 to 1.0 and draw each point it evaluates to. Here's a procedure that does that:
(define (drawcurvepoints curve n) (define (drawcurveworker curve t step) (if (<= t 1.0) (begin (windowdrawpoint (curve t)) (drawcurveworker curve (+ t step) step)))) (drawcurveworker curve 0.0 (/ 1 n)))The procedure drawcurvepoints takes a procedure representing a curve, and n, the number of points to draw. It calls the drawcurveworker procedure. The drawcurveworker procedure takes three parameters: a curve, the current time step values, and the difference between time step values. Hence, to start drawing the curve, drawcurvepoints evaluates drawcurveworked with parameters curve (to pass the same curve that was passed to drawcurvepoints), 0.0 (to start at the first t value), and (/ 1 n) (to divide the time values into n steps).
The drawcurveworker procedure is defined recursively: if t is less than or equal to 1.0, we draw the current point using (windowdrawpoint (curve t)) and draw the rest of the points by evaluating (drawcurveworker curve (+ t step) step)).
The drawcurveworker code uses the special form begin. The evaluation rule for begin is:
Evaluation Rule 4  begin. To evaluate (begin Expression_{1} Expression_{2} ... Expression_{k}), evaluate each subexpression in order from left to right. The value of the begin expression is the value of Expression_{k}.We stop once t is greater than 1.0, since we defined the curve over the interval [0.0, 1.0].
Question 4:

For example, the procedure rotateccw takes a curve and rotates it 90 degrees counterclockwise by swapping the x and y points:
(define (rotateccw curve) (lambda (t) (let ((ct (curve t))) (makecoloredpoint ( (yofpoint ct)) (xofpoint ct) (colorofpoint ct)))))We use let here to avoid needing to evaluate (curve t) more than once. In class, we will see that let is just syntactic sugar (that is, a short way of writing) a procedure application. It binds the value (curve t) evaluates to, to the name ct.
Note that (rotateccw c) evaluates to a curve. The function rotateccw is a procedure that takes a procedure (a curve) and returns a procedure that is a curve.
Predict what (drawcurvepoints (rotateccw midline) 1000) and (drawcurvepoints (rotateccw (rotateccw midline)) 1000) will do. Confirm your predictions by trying them in your Interactions window.
Here's another example:
(define (shrink curve scale) (lambda (t) (let ((ct (curve t))) (makecoloredpoint (* scale (xofpoint ct)) (* scale (yofpoint ct)) (colorofpoint ct)))))Predict what (drawcurvepoints (shrink midline .5) 1000) will do, and then try it in your Interactions window.
The shrink procedure doesn't produce quite what we want because in addition to changing the size of the curve, it moves it around. Why does this happen? Try shrinking a few different curves to make sure you understand why the curve moves.
One way to fix this problem is to center our curves around (0,0) and then translate them to the middle of the screen. We can do this by adding or subtracting constants to the points they produce:
(define (translate curve x y) (lambda (t) (let ((ct (curve t))) (makecoloredpoint (+ x (xofpoint ct)) (+ y (yofpoint ct)) (colorofpoint ct)))))Now we have translate, it makes more sense to define midline this way:
(define (horizline t) (makepoint t 0)) (define midline (translate horizline 0 0.5))
Question 5: To check you understand everything so far, define a procedures drawhalfline that uses translate, horizline and shrink to draw a line half the width of the window that is centered in the middle of the display window. 
In addition to altering the points a curve produces, we can alter a curve by changing the t values it will see. For example,
(define (firsthalf curve) (lambda (t) (curve (/ t 2))))is a function that takes a curve and produces a new curve that is just the first half of the passed curve.
Predict what each of these expressions will do:
The provided code includes several other functions that transform
curves including:
It is also useful to have curve transforms where curves may be combined. An example is (connectrigidly curve1 curve2) which evaluates to a curve that consists of curve1 followed by curve2. The starting point of the new curve is the starting point of curve1 and the end point of curve2 is the ending point of the new curve. Here's how connectrigidly is defined:
(define (connectrigidly curve1 curve2) (lambda (t) (if (< t (/ 1 2)) (curve1 (* 2 t)) (curve2 ( (* 2 t) 1)))))Predict what (drawcurvepoints (connectrigidly verticalmidline midline) 1000) will do. Is there any difference between that and (drawcurvepoints (connectrigidly midline verticalmidline) 1000)? Check your predictions in the Interactions window.
The way connectrigidly is defined above, we use all the tvalues below 0.5 on the first curve, and use the tvalues between 0.5 and 1.0 on the second curve. If the second curve is the result of connecting two other curves, like (connectrigidly c1 (connectrigidly c2 c3)) then 50% of the points will be used to draw c1, 25% to draw c2 and 25% to draw c3.
Question 6: Define a procedure numpoints that determines the approximate
number of tvalues that will be used for the
n^{th} curve when drawing
(connectrigidly c1 (connectrigidly c2 (connectrigidly curve3 (... cn))))Think about this yourself first, but look in main.ss for a hint if you are stuck. There are mathematical ways to calculate this efficiently, but the simplest way to calculate it is to define a procedure that keeps halving the number of points n times to find out how many are left for the n^{th} curve. 
Your numpoints procedure should produce results similar to:
This means if we connected just 20 curves using connectrigidly, and passed the result to drawcurvepoints with one million as the number of points, there would still be only one or two points drawn for the 20^{th} curve. If we are drawing thousands of curves, for most of them, not even a single point would be drawn!> (exact>inexact (numpoints 1000 10))
1.95
> (exact>inexact (numpoints 1000 20))
0.0019073486328125
> (exact>inexact (numpoints 1000000 20))
1.9073486328125
To fix this, we need to distribute the tvalues between our curves more fairly. We have provided a procedure connectcurvesevenly in graphics.ss that connects a list of curves in a way that distributes the range of t values evenly between the curves.
The definition is a bit complicated, so don't worry if you don't understand it completely. You should, however, be able to figure out the basic idea for how it distributed the tvalues evenly between every curve in a list of curves.
It will also be useful to connect curves so that the next curve begins where the first curve ends. We can do this by translating the second curve to begin where the first curve ends. To do this for a list of curves, we translate each curve in the list the same way using map:(define (connectcurvesevenly curvelist) (lambda (t) (let ((whichcurve (if (>= t 1.0) ( (length curvelist) 1) (inexact>exact (floor (* t (length curvelist))))))) ((getnth curvelist whichcurve) (* (length curvelist) ( t (* (/ 1 (length curvelist)) whichcurve)))))))
(define (constocurvelist curve curvelist) (let ((endpoint (curve 1.0))) ;; The last point in curve (cons curve (map (lambda (thiscurve) (translate thiscurve (xofpoint endpoint) (yofpoint endpoint))) curvelist))))
Here is the code for converting a list of LSystem commands with some parts missing (it is explained below, but try to understand it yourself before reading further; if you don't understand cond, review SICP 1.1.6.):
(define (convertlcommandstocurvelist lcommands) (cond ((null? lcommands) (list ;;; We make a leaf with just a single point of green: (lambda (t) (makecoloredpoint 0.0 0.0 (makecolor 0 255 0))) )) ((isforward? (car lcommands)) (constocurvelist verticalline (convertlcommandstocurvelist (cdr lcommands)))) ((isrotate? (car lcommands)) ;;; If this command is a rotate, every curve in the rest ;;; of the list should should be rotated by the rotate angle (let ;; Lsystem turns are clockwise, so we need to use  angle ((rotateangle ( (getangle (car lcommands))))) (map (lambda (curve) ;;; Question 7: fill this in ) ;;; Question 7: fill this in ))) ((isoffshoot? (car lcommands)) (append ;;; Question 8: fill this in )) (#t (error "Bad lcommand!"))))We define convertlcommandstocurvelist recursively. The base case is when there are no more commands (the lcommands parameter is null). It evaluates to the leaf curve (for now, we just make a point of green — you may want to replace this with something more interesting to make a better fractal). Since convertlcommandstocurvelist evaluates to a list of curves, we need to make a list of curves containing only one curve.
Otherwise, we need to do something different depending on what the first command in the command list is. If it is a forward command we draw a vertical line. The rest of the fractal is connected to the end of the vertical line using constocurvelist. The recursive call to convertlcommandstocurve produces the curve list corresponding to the rest of the Lsystem commands. Note how we pass (cdr lcommands) in the recursive call to get the rest of the command list.
Question 7: Fill in the missing code for handling rotate commands (marked as Question 7 in main.ss). You will want to use (rotatearoundorigin curve rotateangle) somewhere in your code to rotate every curve after the rotate command by the rotateangle. 
You can test your code by drawing the curve that results from any list of Lsystem commands that does not use offshoots. For example, evaluating
should produce a "V".(drawcurvepoints (positioncurve (translate (connectcurvesevenly (convertlcommandstocurvelist (makelsystemcommand (makerotatecommand 150) (makeforwardcommand) (makerotatecommand 120) (makeforwardcommand)))) 0.3 0.7) 0 .5) 10000)
Question 8: Fill in the missing code for handling offshoot commands (marked as Question 8 in main.ss). 
We have provided the positioncurve procedure to make it easier to fit fractals onto the graphics window:
(positioncurve curve startx starty) — evaluates to a curve that translates curve to start at (startx, starty) and scales it to fit into the graphics window maintaining the aspect ratio (the x and y dimensions are both scaled the same amount)The code for positioncurve is in curve.ss. You don't need to look at it, but should be able to understand it if you want to.
Now, you should be able to draw any lsystem command list using positioncurve and the convertlcommandstocurvelist function you completed in Questions 7 and 8. Try drawing a few simple Lsystem command lists before moving on to the next part.
Question 9: Define a procedure makelsystemfractal
in main.ss that takes three parameters: replacecommands, a list of Lsystem
commands that replace forward commands in the rewriting; start,
a list of Lsystem commands that describes the starting curve; level,
the number of iterations to apply the rewrite rule.
Hint: You should use the rewritelcommands you defined in Question 3. 
You should be able to draw a tree fractal using maketreefractal and drawlsystemfractal (these and the treecommands list of Lsystem commands are defined in lsystem.ss):
(define (maketreefractal level) (makelsystemfractal treecommands (makelsystemcommand (makeforwardcommand)) level))
(define (drawlsystemfractal lcommands) (drawcurvepoints (positioncurve (connectcurvesevenly (convertlcommandstocurvelist lcommands)) 0.5 0.1) 50000))
For example, (drawlsystemfractal (maketreefractal 3)) will create a tree fractal with 3 levels of branching.
Question 10: Draw some fractals by playing with the Lsystem commands. Try changing the rewrite rule, the starting commands, level and leaf curve (in convertlcommandstocurvelist) to draw an interesting fractal. You might want to make the branches colorful also. Try an make a fractal picture that will make a better course logo than the current Great Lambda Tree Of Infinite Knowledge and Ultimate Power. The best pictures will appear on the course web page and will be rewarded with untold fame, invaluable fortune and maybe even a double gold star on this problem set. 
Summary of materials that you need to turn in:

Submitting

{atlas:maria} submit x500_program3 
Credits: This project is adapted from Professor David Evans' Fall 2005 Course, CS150 and is used by permission from the aforementioned. It was originally created for CS200
Spring 2002 by Dante Guanlao, Jon Erdman and David Evans, and revised
for CS200 Spring 2003 by Jacques Fournier and David Evans, and revised
for CS200 Spring 2004 and CS150 Fall 2005 by David Evans.
