VI Accumulators
When you ask ISL+ to apply some function f to an argument a, you usually get some value v. If you evaluate (f a) again, you get v again.The function application may also loop forever or signal an error, but we ignore these possibilities. We also ignore random, which is the only exception to this rule. As a matter of fact, you get v no matter how often you request the evaluation of (f a). Whether the function is applied for the first time or the hundredth time, whether the application is located in DrRacket’s interactions area or inside the function itself, doesn’t matter. The function works according to its purpose statement, and that’s all you need to know.
This principle of contextindependence plays a critical role in the design
of recursive functions. When it comes to design, you are free to assume
that the function computes what the purpose statement promises—
Although contextindependence facilitates the design of functions, it also causes two problems. The general idea is that contextindependence induces a loss of knowledge during a recursive evaluation; a function does not “know” whether it is called on a complete list or on a piece of that list. For structurally recursive programs this loss of knowledge means that they may have to traverse data more than once, inducing a grave performance cost. For functions that employ generative recursion, the loss means that the function may not be able to compute the result at all; instead the function loops forever for certain inputs. The preceding part illustrates this second problem with a graph traversal function that cannot find a path between two nodes for a circular graph.
This part introduces a variant of the design recipes to address this “loss of context” problem. Since we wish to retain the principle that (f a) returns the same result no matter how often it is evaluated, our only solution is to add an argument that represents the context of the function call. We call this additional argument an accumulator. During the traversal of data, the recursive calls continue to receive new regular arguments while accumulators change in relation to the other arguments and the context of the call.
Designing functions with accumulators correctly is clearly more complex than any of the design approaches from the preceding chapters. The key is to understand the relationship between the proper arguments and the accumulators. The following chapters explain how to design functions with accumulators and how they work.
36 The Loss of Knowledge
Both functions designed according to structural recipes and the generative
one suffer from the loss of knowledge, though in different ways. This
chapter explains with two examples—
36.1 A Problem with Structural Processing
Let’s start with a seemingly straightforward example:
Sample Problem You are working for a geometer team that will measure the length of roads segments. The team asked you to design a program that translates these relative distances between a series of road points into absolute distances for some starting point.
Designing a program that performs this calculation is at this point an
exercise in structural function design. Figure 148
contains the complete program. When the given list is not '(),
the natural recursion computes the absolute distance of the remainder of
the dots to the first item on (rest l). Because the first item
is not the actual origin and has a distance of (first l) to the
origin, we must add (first l) to each number on the result of
the natural recursion. This second step—
; [Listof Number] > [Listof Number] ; convert a list of relative distances to a list of absolute distances ; the first item on the list represents the distance to the origin (checkexpect (relative>absolute '(50 40 70 30 30)) '(50 90 160 190 220)) (define (relative>absolute l) (cond [(empty? l) '()] [else (local ((define restofl (relative>absolute (rest l))) (define adjusted (addtoeach (first l) restofl))) (cons (first l) adjusted))])) ; Number [Listof Number] > [Listof Number] ; add n to each number on l (checkexpect (cons 50 (addtoeach 50 '(40 110 140 170))) '(50 90 160 190 220)) (define (addtoeach n l) (cond [(empty? l) '()] [else (cons (+ (first l) n) (addtoeach n (rest l)))])) Figure 148: Converting relative distances to absolute distances
(relative>absolute (buildlist size add1))
size
1000
2000
3000
4000
5000
6000
7000
time
25
109
234
429
689
978
1365
Exercise 490. Reformulate addtoeach using map and lambda.
Exercise 491. Determine the abstract running time of relative>absolute.
(relative>absolute (buildlist size add1))
Considering the simplicity of the problem, the amount of “work” that the program performs is surprising. If we were to convert the same list by hand, we would tally up the total distance and just add it to the relative distances as we take another step along the line. Why can’t a program use this idea?
(define (relative>absolute/a l) (cond [(empty? l) ...] [else (... (first l) ... (relative>absolute/a (rest l)) ...)]))
== (cons ... 3 ... (relative>absolute/a (list 2 7))) == (cons ... 3 ... (cons ... 2 ... (relative>absolute/a (list 7)))) == (cons ... 3 ... (cons ... 2 ... (cons ... 7 ... (relative>absolute/a '()))))
Put differently, the problem is that recursive functions are independent of their context. A function processes L in (cons N L) in the same manner as in (cons K L). Indeed, it would also process L in that manner if it were given L by itself.
To make up for the loss of “knowledge,” we equip the function with an additional parameter: accudist. The new parameter represents the accumulated distance, which is the tally that we keep when we convert a list of relative distances to a list of absolute distances. Its initial value must be 0. As the function processes the numbers on the list, it must add them to the tally.
(define (relative>absolute/a l accudist) (cond [(empty? l) '()] [else (local ((define tally (+ (first l) accudist))) (cons tally (relative>absolute/a (rest l) tally)))]))
(relative>absolute/a (list 3 2 7)) == (relative>absolute/a (list 3 2 7) 0) == (cons 3 (relative>absolute/a (list 2 7) 3)) == (cons 3 (cons 5 (relative>absolute/a (list 7) 5))) == (cons 3 (cons 5 (cons 12 (relative>absolute/a '() 12)))) == (cons 3 (cons 5 (cons 12 '())))
One minor problem with the new definition is that unlike relative>absolute, the new function consumes two arguments not just one. Worse, someone might accidentally misuse relative>absolute/a by applying it to a list of numbers and a number that isn’t 0. We can solve both problems with a function definition that uses a local definition to encapsulate relative>absolute/a; figure 149 shows the result. Now, relative>absolute and relative>absolute.v2 are indistinguishable with respect to the inputoutput relationship.
; [Listof Number] > [Listof Number] ; convert a list of relative distances to a list of absolute distances ; the first item on the list represents the distance to the origin (checkexpect (relative>absolute.v2 '(50 40 70 30 30)) '(50 90 160 190 220)) (define (relative>absolute.v2 l0) (local (; [Listof Number] Number > [Listof Number] (define (relative>absolute/a l accudist) (cond [(empty? l) '()] [else (local ((define accu (+ (first l) accudist))) (cons accu (relative>absolute/a (rest l) accu)))]))) (relative>absolute/a l0 0))) Figure 149: Converting relative distances with an accumulator
(relative>absolute.v2 (buildlist size add1))
size
1000
2000
3000
4000
5000
6000
7000
time
0
0
0
0
0
1
1
; [Listof Number] > [Listof Number] ; convert a list of relative distances to a list of absolute distances ; the first item on the list represents the distance to the origin (checkexpect (relative>absolute '(50 40 70 30 30)) '(50 90 160 190 220)) (define (relative>absolute l) (reverse (foldr (lambda (f l) (cons (+ f (first l)) l)) (list (first l)) (reverse (rest l)))))
Does your friend’s solution mean there is no need for our complicated design in this motivational section? For a solution, see Recognizing the Need for an Accumulator, but do reflect on the question first and better still try to design reverse on your own.
36.2 A Problem with Generative Recursion
Sample Problem Design an algorithm that checks whether two nodes are connected in a simple graph. In a simple graph, each node has exactly one, onedirectional connection to another node, possibly itself.
Consider the sample graph in figure 150. There are six nodes: A through F, and six connections. To get from A to E, you must go through B and C. It is impossible, though, to reach F from A or from any other node besides F itself.
(define asimplegraph '((A B) (B C) (C E) (D E) (E B) (F F)))
; A SimpleGraph is a [Listof Connection] ; A Connection is a list of two items: ; (list Node Node) ; A Node is a Symbol.
; Node Node SimpleGraph > Boolean ; is there a path from origination to destination in sg (checkexpect (pathexists? 'A 'E asimplegraph) #true) (checkexpect (pathexists? 'A 'F asimplegraph) #false) (define (pathexists? origination destination sg) #false)
The problem is trivial if the nodes origination and destination are the same.
The trivial solution is #true.
If origination is not the same as destination, there is only one thing we can do: step to the immediate neighbor and search for destination from there.
There is no need to do anything if we find the solution to the new problem. If origination’s neighbor is connected to destination, then so is origination. Otherwise there is no connection.
; Node Node SimpleGraph > Boolean ; is there a path from origination to destination in sg (checkexpect (pathexists? 'A 'E asimplegraph) #true) (checkexpect (pathexists? 'A 'F asimplegraph) #false) (define (pathexists? origination destination sg) (cond [(symbol=? origination destination) #t] [else (pathexists? (neighbor origination sg) destination sg)])) ; Node SimpleGraph > Node ; determine the node that is connected to anode in sg (checkexpect (neighbor 'A asimplegraph) 'B) (checkerror (neighbor 'G asimplegraph) "neighbor: not a node") (define (neighbor anode sg) (cond [(empty? sg) (error "neighbor: not a node")] [else (if (symbol=? (first (first sg)) anode) (second (first sg)) (neighbor anode (rest sg)))]))
Figure 151 contains the complete program, including the
function for looking up the neighbor of a node in a simple graph—
(pathexists? 'C 'D '((A B) (B C) (C E) (D E) (E B) (F F))) == (pathexists? 'E 'D '((A B) (B C) (C E) (D E) (E B) (F F))) == (pathexists? 'B 'D '((A B) (B C) (C E) (D E) (E B) (F F))) == (pathexists? 'C 'D '((A B) (B C) (C E) (D E) (E B) (F F)))
Our problem with pathexists? is again a loss of “knowledge,” similar to that of relative>absolute in the preceding section. Like relative>absolute, the design of pathexists? uses a recipe and assumes contextindependence for recursive calls. In the case of pathexists? this means, in particular, that the function doesn’t “know” whether a previous application in the current chain of recursions received the exact same arguments.
The solution to this design problem follows the pattern of the preceding section. We add a parameter, which we call seen and which represents the accumulated list of origination nodes that the function has encountered, starting with the original application. Its initial value must be '(). As the function checks on a specific origination and moves to its neighbors, origination is added to seen.
; Node Node SimpleGraph [Listof Node] > Boolean ; is there a path from origination to destination in sg ; assume the nodes in seen are known not to solve the problem (define (pathexists?/a origination destination sg seen) (cond [(symbol=? origination destination) #t] [else (pathexists?/a (neighbor origination sg) destination sg (cons origination seen))]))
(pathexists?/a 'C 'D '((A B) (B C) (C E) (D E) (E B) (F F)) '())
== (pathexists?/a 'E 'D '((A B) (B C) (C E) (D E) (E B) (F F)) '(C)) == (pathexists?/a 'B 'D '((A B) (B C) (C E) (D E) (E B) (F F)) '(E C)) == (pathexists?/a 'C 'D '((A B) (B C) (C E) (D E) (E B) (F F)) '(B E C))
All we need to do now, is to make the algorithm exploit the accumulated knowledge. Specifically, the algorithm can determine whether the given origination is already an item in seen. If so, the problem is also trivially solvable yielding #false as the solution. Figure 152 contains the definition of pathexists.v2?, which is the revision of pathexists?. The definition refers to member?, an ISL+ function.
; Node Node SimpleGraph > Boolean ; is there a path from origination to destination in sg (checkexpect (pathexists.v2? 'A 'E asimplegraph) #true) (checkexpect (pathexists.v2? 'A 'F asimplegraph) #false) (define (pathexists.v2? origination destination sg) (local (; Node Node SimpleGraph [Listof Node] > Boolean (define (pathexists?/a origination seen) (cond [(symbol=? origination destination) #t] [(member? origination seen) #f] [else (pathexists?/a (neighbor origination sg) (cons origination seen))]))) (pathexists?/a origination '()))) Figure 152: Finding a path in a simple graph with an accumulator
The definition of pathexists.v2? also eliminates the two minor problems with the first revision. By localizing the definition of the accumulating function, we can ensure that the first call always uses '() as the initial value for seen. And, pathexists.v2? satisfies the exact same signature and purpose statement as the pathexists? function.
Still, there is a significant difference between pathexists.v2? and relativetoabsolute2. Whereas the latter was equivalent to the original function, pathexists.v2? improves on pathexists?. While the latter fails to find an answer for some inputs, pathexists.v2? finds a solution for any simple graph.
Exercise 493. Modify the definitions of findpath and findpath/list in figure 140 so that they produce #false, even if they encounter the same starting point twice.
37 Designing Accumulatorstyle Functions
The preceding chapter illustrates the need for accumulating extra knowledge with two examples. In one case, accumulation makes it easy to understand the function and yields one that is far faster than the original version. In the other case, accumulation is necessary for the function to work properly. In both cases though, the need for accumulation becomes only apparent once a properly designed function exists.
the recognition that a function benefits from an accumulator;
an understanding of what the accumulator represents with respect to the design.
37.1 Recognizing the Need for an Accumulator
If a structurally recursive function processes the result of its natural recursion with an auxiliary, recursive function, consider the use of an accumulator parameter.
Take a look at the definition of invert:; [Listof X] > [Listof X] ; construct the reverse of alox (checkexpect (invert '(a b c)) '(c b a)) (define (invert alox) (cond [(empty? alox) '()] [else (addaslast (first alox) (invert (rest alox)))])) ; X [Listof X] > [Listof X] ; add anx to the end of alox (checkexpect (addaslast 'a '(c b)) '(c b a)) (define (addaslast anx alox) (cond [(empty? alox) (list anx)] [else (cons (first alox) (addaslast anx (rest alox)))])) The result of the recursive application produces the reverse of the rest of the list. It is processed by addaslast, which adds the first item to the reverse of the rest and thus creates the reverse of the entire list. This second, auxiliary function is also recursive. We have thus identified a potential candidate.It is now time to study some handevaluations, as we did in A Problem with Structural Processing, to see whether an accumulator helps. Consider the following expression and its evaluation:(invert '(a b c)) == (addaslast 'a (invert '(b c))) == (addaslast 'a (addaslast 'b (invert '(c)))) == (addaslast 'a (addaslast 'b (addaslast 'c (invert '())))) == (addaslast 'a (addaslast 'b (addaslast 'c '()))) == (addaslast 'a (addaslast 'b '(c))) == (addaslast 'a '(c b)) == '(c b a) Eventually invert reaches the end of the given list—just like addaslast— and if it knew which items to put there, there would be no need for the auxiliary function. If we are dealing with a function based on generative recursion, we are faced with a much more difficult task. Our goal must be to understand whether the algorithm can fail to produce a result for inputs for which we expect a result. If so, adding a parameter that accumulates knowledge may help. Because these situations are complex, we defer the discussion of an example to More Uses of Accumulation.
Exercise 494. Argue that, in the terminology of Intermezzo: The Cost of Computation, invert consumes O(n2) time when the given list consists of n items.
Exercise 495. Does the insertion sort> function from Recursive Auxiliary Functions need an accumulator? If so, why? If not, why not?
37.2 Adding Accumulators
Determine the knowledge that the accumulator represents, what kind of data to use, and how the knowledge is acquired as data.
For example, for the conversion of relative distances to absolute distances, it suffices to accumulate the total distance encountered so far. As the function processes the list of relative distances, it adds each new relative distance found to the accumulator’s current value. For the routing problem, the accumulator remembers every node encountered. As the pathchecking function traverses the graph, it conses each new node on to the accumulator.
In general, you want to proceed as follows. Create an accumulator template:
; Domain > Range (define (function d0) (local (; Domain AccumulatorDomain > Range ; accumulator ... (define (function/a d a) ...)) (function/a d0 a0))) Sketch a manual evaluation of an application of function to understand the nature of the accumulator. Determine the kind of data that the accumulator tracks.
Write down a statement that explains the accumulator as a relationship between the argument d of the auxiliary function/a and the original argument d0.
Note The relationship remains constant—
also called invariant— over the course of the evaluation. Because of this property, an accumulator statement is also called an accumulator invariant. Use the accumulator statement to determine the initial value a0 for a.
Also exploit the accumulator statement to determine how to compute the accumulator for the recursive function calls within the definition of function/a.
Exploit the accumulator’s knowledge for the design of the auxiliary function.
For a structurally recursive function, the accumulator’s value is typically used in the base case, that is, the cond clause that does not recur. For functions that use generative recursive functions, the accumulated knowledge might be used in an existing base case, in a new base case, or in the cond clauses that deal with generative recursion.
; [Listof X] > [Listof X] ; construct the reverse of alox0 (checkexpect (invert.v2 '(a b c)) '(c b a)) (define (invert.v2 alox0) (local (; [Listof X] ??? > [Listof X] ; construct the reverse of alox ; accumulator ... (define (invert/a alox a) (cond [(empty? alox) ...] [else (invert/a (rest alox) ... a ...)]))) (invert/a alox0 ...)))
(invert '(a b c))
== (invert/a '(a b c) a0) == (invert/a '(b c) ... 'a ... a0) == (invert/a '(c) ... 'b ... 'a ... a0) == (invert/a '() ... 'c ... 'b ... 'a ... a0)
(define (invert.v2 alox0) (local (; [Listof X] [Listof X] > [Listof X] ; construct the reverse of alox ; accumulator a is the list of all those items ; on alox0 that precede alox in reverse order (define (invert/a alox a) (cond [(empty? alox) a] [else (invert/a (rest alox) (cons (first alox) a))]))) (invert/a alox0 '())))
Note how once again invert.v2 traverses the list just. In contrast, invert reprocesses every result of its natural recursion with addaslast. Stop! Measure how much faster invert.v2 runs than invert on the same list.
Terminology Programmers use the phrase accumulatorstyle function when they discuss functions that use an accumulator parameter. Examples of functions in accumulatorstyle are relative>absolute/a, pathexists?/a, and invert/a.
37.3 Transforming Functions into AccumulatorStyle
Articulating the accumulator statement is difficult but without formulating a good invariant, it is impossible to understand an accumulatorstyle function. Since the goal of a programmer is to make sure that others who follow understand the code easily, practicing this skill is critical. And formulating invariants deserves a lot of practice.
The goal of this section is to study the formulation of accumulator statements with three case studies: a summation function, the factorial function, and a treetraversal function. Each such case is about the conversion of a structurally recursive function into accumulator style. None actually call for the use of an accumulator parameter. But they are easily understood and, with the elimination of all other distractions, using such examples allows us to focus on the articulation of the accumulator invariant.
; [Listof Number] > Number ; compute the sum of the numbers on alon (checkexpect (sum '(10 4 6)) 20) (define (sum alon) (cond [(empty? alon) 0] [else (+ (first alon) (sum (rest alon)))]))
; [Listof Number] > Number ; compute the sum of the numbers on alon0 (checkexpect (sum.v2 '(10 4 6)) 20) (define (sum.v2 alon0) (local (; [Listof Number] ??? > Number ; compute the sum of the numbers on alon ; accumulator ... (define (sum/a alon a) (cond [(empty? alon) ...] [else (... (sum/a (rest alon) ... a ...) ...)]))) (sum/a alon0 ...)))
(sum '(10 4)) ==
(sum.v2 '(10 4)) ==
== (+ 10 (sum '(4))) == (+ 10 (+ 4 (sum '()))) == (+ 10 (+ 4 (+ 0))) ... == 14
== (sum/a '(10 4) a0) == (sum/a '(4) ... 10 ... a0) == (sum/a '() ... 4 ... 10 ... a0) ... == 14
a represents the sum of the numbers that alon lacks in comparison to alon0
(define (sum.v2 alon0) (local (; [Listof Number] ??? > Number ; compute the sum of the numbers on alon ; accumulator a represents the sum of the numbers ; that alon lacks in comparison to alon0 (define (sum/a alon a) (cond [(empty? alon) a] [else (sum/a (rest alon) (+ (first alon) a))]))) (sum/a alon0 0)))
(sum/a '(10 4) 0)
Note on Numbers Remember that for exact numbers, this difference has no effect on the final result. For inexact numbers, the difference can be significant. See the exercises at the end of Intermezzo: The Cost of Computation.
; N > N ; compute (* n ( n 1) ( n 2) ... 1) (checkexpect (! 3) 6) (define (! n) (cond [(zero? n) 1] [else (* n (! (sub1 n)))]))
; N > N ; compute (* n0 ( n0 1) ( n0 2) ... 1) (checkexpect (!.v2 3) 6) (define (!.v2 n0) (local (; N ??? > N ; compute (* n ( n 1) ( n 2) ... 1) ; accumulator ... (define (!/a n a) (cond [(zero? n) ...] [else (... (!/a (sub1 n) ... a ...) ...)]))) (!/a n0 ...)))
(! 3) =  (!.v2 3) =  


a is the product of the natural numbers in the interval [n0,n).
Exercise 498. What should the value of a be when n0 is 3 and n is 1? How about when n0 is 10 and n is 8?
(define (!.v2 n0) (local (; N N > N ; compute (* n ( n 1) ( n 2) ... 1) ; accumulator a is the product of the natural ; numbers in the interval [n0,n). (define (!/a n a) (cond [(zero? n) a] [else (!/a (sub1 n) (* n a))]))) (!/a n0 1)))
Exercise 499. Like sum, ! performs the
primitive computation steps—
Measure how long it takes to evaluate (! 20) one thousand times. Recall that (time anexpression) function determines how long it takes to run anexpression.
For the third and last example, we use a function that measures the height of simplified binary trees. The example illustrates that accumulatorstyle programming applies to all kinds of data, not just those defined with single selfreferences. Indeed, it is as common for complicated data definitions as it is for lists and natural numbers.
(definestruct node [left right]) ; A Tree is one of: ; – '() ; – (makenode Tree Tree) (define example (makenode (makenode '() (makenode '() '())) '()))
; Tree > N ; measure the height of abt0 (checkexpect (height example) 3) (define (height abt) (cond [(empty? abt) 0] [else (+ (max (height (nodeleft abt)) (height (noderight abt))) 1)]))
'()
(makenode '() '())
(makenode (makenode '() (makenode '() '())) '())
; Tree > N ; measure the height of abt0 (checkexpect (height.v2 example) 3) (define (height.v2 abt0) (local (; Tree ??? > N ; measure the height of abt ; accumulator ... (define (height/a abt a) (cond [(empty? abt) ...] [else (... (height/a (nodeleft abt) ... a ...) ... ... (height/a (noderight abt) ... a ...) ...)]))) (height/a abt0 ...)))
a is the number of steps it takes to reach abt from abt0.
If abt0 is the complete tree and abt is the subtree pointed to by the circled 1, the accumulator’s value must be 1 because it takes exactly one step to get from the root of abt to the root of abt0.
In the same spirit, for the subtree labeled 2 the accumulator is 2 because it takes two steps to get this place.
(define (height.v2 abt0) (local (; Tree N > N ; measure the height of abt ; accumulator a is the number of steps ; it takes to reach abt from abt0 (define (height/a abt a) (cond [(empty? abt) a] [else (... (height/a (nodeleft abt) (+ a 1)) ... ... (height/a (noderight abt) (+ a 1)) ...)]))) (height/a abt0 0)))
Following the design recipe also tells us that we need to interpret the two values to find the appropriate function. According to the purpose statement for height/a, the first value is the height of the left subtree, and the second one is the height of the right one. Given that we are interested in the height of abt itself and that the height is the largest number of steps it takes to reach a leaf, we use the max function to pick the proper one; see figure 154 for the complete definition.
; Tree > N ; measure the height of abt0 (checkexpect (height.v2 example) 3) (define (height.v2 abt0) (local (; Tree N > N ; measure the height of abt ; accumulator a is the number of steps ; it takes to reach abt from abt0 (define (height/a abt a) (cond [(empty? abt) a] [else (max (height/a (nodeleft abt) (+ a 1)) (height/a (noderight abt) (+ a 1)))]))) (height/a abt0 0)))
the first accumulator, a, represents the number of steps it takes to reach abt from abt0 and the second accumulator, stands for the tallest branch in the part of abt0 that is to the left of abt.
(define (height.v3 abt0) (local (; Tree N N > N ; measure the height of abt ; accumulator s is the number of steps ; it takes to reach abt from abt0 ; accumulator m is the maximal height of ; the part of abt0 that is to the left of abt (define (h/a abt s m) (cond [(empty? abt) ...] [else (... (h/a (nodeleft abt) ... s ... ... m ...) ... ... (h/a (noderight abt) ... s ... ... m ...) ...)]))) (h/a abt0 ...)))
Exercise 500. Complete the design of height.v3.
Hint In terms of the bottommost tree of figure 153, the place marked 1 has no complete paths to leafs to its left while the place marked 2 has one complete path and it consists of two steps.
This second design has a more complex accumulator invariant than the first one. By implication, its implementation requires more care than the first one. At the same time, it comes without any advantages, meaning it is inferior to the first one.
Our point is that different accumulator invariants yield different variants. You can design both variants systematically following the same design recipe. When you have complete function definitions, you can compare and contrast the results, and you can then decide which one to keep based on evidence. End
Exercise 501. Design an accumulatorstyle version of product, the function that computes the product of a list of numbers. Stop when you have formulated the accumulator invariant and have someone check it.
The performance of product is O(n) where n is the length of the list. Does the accumulator version improve on this?
Exercise 502. Design an accumulatorstyle version of howmany, which is the function that determines the number of items on a list. Stop when you have formulated the accumulator invariant and have someone check it.
The performance of howmany is O(n) where n is the length of the list. Does the accumulator version improve on this?
Computer scientists refer to this space as stack space but you can safely ignore this terminology for now.
; N > Number ; add n to pi without use + (checkwithin (addtopi 2) (+ 2 pi) 0.001) (define (addtopi n) (cond [(zero? n) pi] [else (add1 (addtopi (sub1 n)))]))
Exercise 504. Design the function makepalindrome, which accepts a nonempty list and constructs a palindrome by mirroring the list around the last item. When given (explode "abc"), it yields (explode "abcba").
; [NEListof 1String] > [NEListof 1String] ; create a palindrome by mirroring the given list around the last item (checkexpect (mirror (explode "abc")) (explode "abcba")) (define (mirror s0) (append (allbutlast s0) (list (last s0)) (reverse (allbutlast s0))))
via allbutlast,
via last,
via allbutlast again, and
via reverse, which is ISL+’s version of inverse.
; Matrix > Matrix ; find the first row that doesn't start with 0 and use it as the first one ; generative move the first row to last place ; termination this function does not terminate if all rows in M start with 0 (checkexpect (rotateuntil.v2 '((0 4 5) (1 2 3))) '((1 2 3) (0 4 5))) (define (rotate M) (cond [(not (= (first (first M)) 0)) M] [else (rotate (append (rest M) (list (first M))))]))
rows in M
1000
2000
3000
4000
5000
17
66
151
272
436
; Matrix > Matrix ; find the first row that doesn't start with 0 and use it as the first one (define (rotate.v2 M0) (local (; Matrix ... > Matrix ; accumulator ... (define (rotate/a M seen) (cond [(empty? M) ...] [else (... (rotate/a (rest M) ... seen ...) ...)]))) (rotate M0 ...)))
Formulate an accumulator statement. Then follow the accumulator design recipe to complete the above function. Measure how fast it runs on a Matrix that consists of rows with leading 0s except for the last one. If you completed the design correctly, the function is quite fast.
Exercise 506. Design to10. It consumes a list of digits and produces the corresponding number. The first item on the list is the most significant digit. Hence, when applied to '(1 0 2), it produces 102.
Exercise 507. Design the function isprime, which consumes a natural number and returns #true if it is prime and #false otherwise.
Domain Knowledge A number n is prime if it is not divisible by any number between n  1 and 2.
; N [>=1] > Boolean ; determine whether n is a prime number (define (isprime? n) (cond [(= n 1) ...] [else (... (isprime? (sub1 n)) ...)]))
!
5.760
5.780
5.800
5.820
5.870
5.806
!.v2
5.970
5.940
5.980
5.970
6.690
6.111
Exercise 508. Design an accumulatorstyle version of map.
(checkexpect (myfoldl + 0 '(1 2 3)) (foldl + 0 '(1 2 3))) (checkexpect (myfoldl cons '() '(a b c)) (foldl cons '() '(a b c))) ; version 1 (define (myfoldl f e l) (foldr f e (reverse l)))
; version 2 (define (myfoldl f e l) (local ((define (reverse l) (cond [(empty? l) '()] [else (addtoend (first l) (reverse (rest l)))])) (define (addtoend x l) (cond [(empty? l) (list x)] [else (cons (first l) (addtoend x (rest l)))])) (define (foldr l) (cond [(empty? l) e] [else (f (first l) (foldr (rest l)))]))) (foldr (reverse l))))
; version 3 (define (myfoldl f e l) (local ((define (invert/a l a) (cond [(empty? l) a] [else (invert/a (rest l) (cons (first l) a))])) (define (foldr l) (cond [(empty? l) e] [else (f (first l) (foldr (rest l)))]))) (foldr (invert/a l '()))))
; version 4 (define (myfoldl f e l0) (local ((define (fold/a a l) (cond [(empty? l) a] [else (fold/a (f (first l) a) (rest l))]))) (fold/a e l0)))
; [X Y > Y] Y [Listof X] > Y
; version 5 (define (myfoldl f i l) (cond [(empty? l) i] [else (myfoldl f (f (first l) i) (rest l))]))
(checkexpect (mybuildlist n f) (buildlist n f))
37.4 A Graphical Editor, with Mouse
A Graphical Editor introduces the notion of a oneline editor and presents a number of exercises on creating a graphical editor. Recall that a graphical editor is an interactive program that interprets key events as editing actions on a string. In particular, when a user presses the left or right arrow key, the cursor moves left or right; similarly, pressing the delete key removes a 1String from the edited text. The editor program uses a data representation that combines two strings in a structure. A Graphical Editor, Revisited resumes these exercises and shows how the same program can greatly benefit from a different data structure, one that combines two strings.
Neither of these sections deals with mouse actions for navigation, even though all modern applications support this functionality. The basic difficulty with mouse events is to place the cursor at the appropriate spot. Since the program deals with a single line of text, a mouse click at (x,y) clearly aims to place the cursor between the letters that are visible at or around the x position. This section fills the gap.
Recall the relevant definitions from A Graphical Editor, Revisited:
(define FONTSIZE 11) (define FONTCOLOR "black") ; [Listof 1String] > Image ; render a string as an image for the editor (define (editortext s) (text (implode s) FONTSIZE FONTCOLOR)) (definestruct editor [pre post]) ; An Editor is a structure: ; (makeeditor [Listof 1String] [Listof 1String]) ; interpretation if (makeeditor p s) is the state of an ; interactive editor, (reverse p) corresponds to the text to the ; left of the cursor and s to the one on its right
(makeeditor p s)
(string=? (stringappend p s) ed)
(<= (imagewidth (editortext p)) x (imagewidth (editortext (append p (first s)))))
Hints (1) The xcoordinate measures the distance from the left. Hence the function must check whether smaller and smaller prefixes of ed fit into the given width. The first one that doesn’t fit corresponds to the pre field of the desired Editor, the remainder of ed to the post field.
(2) Designing this function calls for thoroughly developing examples and tests. See Intervals, Enumerations, Itemizations.
Exercise 511. Design the function split. Use the accumulator design recipe to improve on the result of exercise 510. After all, the hints already point out that when the function discovers the correct split point, it needs both parts of the list and one part is obviously lost due to recursion.
Once you have solved this exercise, equip the main function of
A Graphical Editor, Revisited with a clause for mouse
clicks. As you experiment with moving the cursor via mouse clicks, you will
notice that it does not exactly behave like applications that you use on
your other devices—
Graphical programs, like editors, call for experimentation to come up with best “look and feel” experiences. In this case, your editor is too simplistic with its placement of the cursor. After the applications on your computer determine the split point, they also determine which letter division is closer to the xcoordinate and place the cursor there.
Exercise 512. Many operating systems come with the fmt program, which can rearrange the words in a file so that all lines in the resulting file have a maximal width. As a widely used program, fmt supports a range of related functions. This exercise focuses on its core functionality.
Design the program fmt. It consumes a natural number w,
the name of an input file inf, and the name of an output file
outf—
38 More Uses of Accumulation
This chapter presents three more uses of accumulators. The first section concerns the use of accumulators in conjunction with treeprocessing functions. It uses the compilation of ISL+ as an illustrative example. The second section explains why we occasionally want accumulators inside of data representations and how to go about it. The final section resumes the discussion of rendering fractals.
38.1 Accumulators and Trees
When you ask DrRacket to run an ISL+ program, it translates the program to commands for your specific computer. This process is called compilation and the part of DrRacket that performs the task is called a compiler. Before the compiler translates the ISL+ program, it checks that every variable is declared via a define, definestruct, or a lambda.
Stop! Enter x, (lambda (y) x), and (x 5) as complete ISL+ programs into DrRacket and ask it to run each. What do you expect to see?
Sample Problem You have been hired to recreate a part of the ISL+ compiler. Specifically, your task deals with the following language fragment, specified in the socalled grammar notation that many programming language manuals use:We use the Greek letter λ instead of lambda to signal that this exercise deals with ISL+ as an object of study not just a programming language.
expression = variable  (λ (variable) expression)  (expression expression) Remember from BSL Grammar that you can read the grammar aloud replacing = with “is one of” and  with “or.”Recall that λ expressions are functions without names. They bind their parameter in their body. Conversely, a variable occurrence is declared by a surrounding λ that specifies the same name as a parameter. You may wish to revisit Intermezzo: Scope and Abstraction because it deals with the same issue from the perspective of a programmer. Look for the terms “binding occurrence,” “bound occurrence,” and “free.”
Develop a data representation for the above language fragment; use symbols to represent variables. Then design a function that replaces all undeclared variables with '*undeclared.
(λ (x) x) is the function that returns whatever it is given, also known as the identity function;
(λ (x) y) looks like a function that returns y whenever it is given an argument, except that y isn’t declared;
(λ (y) (λ (x) y)) is a function that, when given some value v, produces a function that always returns v;
((λ (x) x) (λ (x) x)) applies the identity function to itself;
(((λ (y) (λ (x) y)) (λ (z) z)) (λ (w) w)) is a complex expression that is best run in ISL+ to find out whether it even terminates.
Exercise 513. Explain the scope of each binding occurrence in the above examples. Draw arrows from all bound occurrences to the binding occurrences.
(define ex1 '(λ (x) x)) (define ex2 '(λ (x) y)) (define ex3 '(λ (y) (λ (x) y))) (define ex4 '((λ (x) (x x)) (λ (x) (x x))))
Exercise 514. Define the functions isvar?, isλ?, and isapp?, predicates that distinguish (representations of) variables from λ expressions and applications.
λpara, which extracts the parameter from a λ expression;
λbody, which extracts the body from a λ expression;
appfun, which extracts the function from an application; and
apparg, which extracts the argument from an application.
Design declareds, which produces the list of all symbols used as λ parameters in a λ term. Don’t worry about duplicate symbols.
Exercise 515. Develop a data representation for the same subset of ISL+ that uses structures instead of lists. Also provide data representations for ex1, ex2, and ex3 following you data definition.
; Lam > Lam ; replace all symbols s in le with '*undeclared if they do ; not occur within the body of a λ whose parameter is s (checkexpect (undeclareds ex1) ex1) (checkexpect (undeclareds ex2) '(λ (x) *undeclared)) (checkexpect (undeclareds ex3) ex3) (checkexpect (undeclareds ex4) ex4) (define (undeclareds le0) le0)
(define (undeclareds le) (cond [(isvar? le) ...] [(isλ? le) (... (undeclareds (λbody le)) ...)] [(isapp? le) (... (undeclareds (appfun le)) (undeclareds (apparg le)) ...)]))
(define (undeclareds le0) (local (; Lam ??? > Lam ; accumulator a represents ... (define (undeclareds/a le a) (cond [(isvar? le) ...] [(isλ? le) (... (undeclareds (λbody le) ... a ...) ...)] [(isapp? le) (... (undeclareds (appfun le) ... a ...) (undeclareds/a (apparg le) ... a ...) ...)]))) (undeclareds/a le0 ...)))
a represents the list of λ parameters encountered on the path from le0 to le.
'(((λ (y) (λ (x) y)) (λ (z) z)) (λ (w) w))
'(((λ (y) (λ (x) y)) (λ (z) z)) (λ (w) w))
Figure 155: Lam terms as trees
the initial accumulator value of '();
we can use cons to add (λpara le) to a; and
once undeclareds/a reaches a variable, it can use the accumulator to check whether the variable is in the scope of a declaration.
Figure 156 shows how to translate these ideas into a complete function definition. Note the name declareds for the accumulator; it brings across the key idea behind the accumulator invariant, helping the programmer understand the definition. The base case uses member? from ISL+ to determine whether the variable le is in declareds and, if not, replaces it with '*undeclared. The second cond clause uses a local to introduce the extended accumulator newd. Because para is also used to rebuild the expression, it has its own local definition. Finally, the last clause concerns function applications, which do not declare variables and do not use any directly. As a result, it is by far the simplest of the three clauses.
; Lam > Lam ; replace all symbols s in le with '*undeclared if they do ; not occur within the body of a λ whose parameter is s (checkexpect (undeclareds ex1) ex1) (checkexpect (undeclareds ex2) '(λ (x) *undeclared)) (checkexpect (undeclareds ex3) ex3) (checkexpect (undeclareds ex4) ex4) (define (undeclareds le0) (local (; Lam [Listof Symbol] > [Listof Symbol] ; accumulator declareds is a list of all λ ; parameters on the path from le0 to le (define (undeclareds/a le declareds) (cond [(isvar? le) (if (member? le declareds) le '*undeclared)] [(isλ? le) (local ((define para (λpara le)) (define newd (cons para declareds)) (define body (undeclareds/a (λbody le) newd))) (list 'λ (list para) body))] [(isapp? le) (list (undeclareds/a (appfun le) declareds) (undeclareds/a (apparg le) declareds))]))) (undeclareds/a le0 '())))
Exercise 516. Make up an ISL+ expression in which x occurs both free and bound. Formulate it as an element of Lam. Does undeclareds work properly on your expression?
(list '*undeclared 'x)
(list '*declared 'y)
Note The trick to replace a variable occurrence with the representation of an application feels awkward. If you dislike it, consider synthesizing the symbols '*undeclared:x and 'declared:y instead.
Exercise 518. Redesign the undeclareds function for the structurebased data representation from exercise 515.
'((λ (x) (λ (y) (y x))) (λ (z) z))
Hint The undeclareds accumulator of undeclareds/a
is a list of all parameters on path from le to le0
in reverse order—
38.2 Data Representations with Accumulators
See Finite State Machines for an early example of this idea
The end of Intermezzo: The Cost of Computation explains that *SL measures the size of
containers—
Consider the ubiquitous lists in *SL. All lists are constructed from cons and '(); operations such as quote and list, for example, are merely abbreviations for these two. As What Is '(), What Is cons shows, it is also possible to mimic lists in BSL with suitable structure type and function definitions.
(definestruct pair [head right]) ; ConsOrEmpty is one of: ; – '() ; – (makepair Any ConsOrEmpty) ; Any ConsOrEmpty > ConsOrEmpty (define (ourcons avalue alist) (cond [(empty? alist) (makepair avalue alist)] [(ourcons? alist) (makepair avalue alist)] [else (error "cons: list as second argument expected")])) ; ConsOrEmpty > Any ; extracts the left part of the given pair (define (ourfirst mimickedlist) (if (empty? mimickedlist) (error 'ourfirst "...") (pairleft mimickedlist)))
; structure type definition (definestruct cpair [count left right]) ; A [MyList X] is one of: ; – '() ; – (makecpair (tech "N") X [MyList X]) ; accumulator the count field is the number of cpairs in the list
; data definitions, via a constructorfunction (define (ourcons f r) (cond [(empty? r) (makecpair 1 f r)] [(cpair? r) (makecpair (+ (cpaircount r) 1) f r)] [else (error 'cons "second argument must be a list, but ...")]))
; Any > N ; how many items does l contain (define (ourlength l) (cond [(empty? l) 0] [(cpair? l) (cpaircount l)] [else (error 'mylength "expects a list, given ...")]))
The second problem with the addition of a count field concerns
performance. Indeed, there are two concerns. On one hand, every single
list construction comes with an extra field now, meaning a 33% increase in
memory consumption. On the other hand, the addition of the field decreases
how fast ourcons constructs a list. In addition to the check
that the extended list is either '() or an instance of a cpair,
the constructor now computes the size of the list. Although this
computation consumes a constant amount of time, it is imposed on every
single use of ourcons—
Exercise 520. Argue that ourpair takes a constant amount of time to compute its result, regardless of the size of its input.
Exercise 521. Is it acceptable to impose the extra cost on cons for all programs to turn length into a constanttime function?
While the addition of count field to list is questionable, sometimes data accumulators play a crucial role in finding a solution. The next example is about adding socalled artificial intelligence to a boardgame playing program, and its data accumulator is an absolute necessity.
Sample Problem Your manager tells you the following story.
“Once upon a time, three cannibals were guiding three missionaries through a jungle. They were on their way to the nearest mission station. After some time, they arrived at a wide river, filled with deadly snakes and fish. There was no way to cross the river without a boat. Fortunately, they found a rowing boat with two oars after a short search. Unfortunately, the boat was too small to carry all of them. It could barely carry two people at a time. Worse, because of the river’s width someone had to row the boat back.
“Since the missionaries could not trust the cannibals, they had to figure out a plan to get all six of them safely across the river. The problem was that these cannibals would kill and eat missionaries as soon as there were more cannibals than missionaries at some place. Thus our missionaries had to devise a plan that guaranteed that there were never any missionaries in the minority at either side of the river. The cannibals, however, could be trusted to cooperate otherwise. Specifically, they wouldn’t abandon any potential food, just as the missionaries wouldn’t abandon any potential converts.”
While your manager doesn’t assign any specific design task, he wants to explore whether the company can design (and sell) programs that solve such puzzles.
In principle, it is quite straightforward to solve such puzzles by hand. Here is the rough idea. Pick a graphical representation of the problem states. Ours consists of a threepart box: the left one represents the missionaries and the cannibals on the left; the middle combines the river and the boat; and the third part is the righthand side of the river. Take a look at the following representation of the initial state:
Now that you have a way to write down the state of the puzzle, you can think about the possibilities at each stage. Doing so yields a tree of possible moves. Figure 158 sketches the first two and a half layers in such a tree. The leftmost state is the initial one. Because the boat can transport at most two people and must be rowed by at least one, you have five possibilities to explore: one cannibal rows across, two, one missionary and one cannibal go, one missionary, or two missionaries. These possibilities are represented with five arrows going from the initial state to five intermediate states.
For each of these five intermediate states, you can play the same game again. In figure 158 you see how the game continues for the middle (third) one of the new states. Because there are only two people on the right river bank, you see three possibilities: a cannibal goes back, a missionary, or both. Hence three arrows connect the middle state to the three states on the right side of the tree.
If you keep drawing the tree of possibilities—
A close look at figure 158 reveals two problems with this naive approach to generating the tree of possibilities. The first one is the dashed arrow that connects the middle state on the right to the initial state. It indicates that rowing back the two people from the right to the left gets the puzzle back to its initial state, meaning you’re starting over, which is obviously undesirable. The second problem concerns those states with a star in the topright corner. In both cases, there are more whitecircle cannibals than blackcircle missionaries on the left river bank, meaning the cannibals would eat the missionaries. Again, the goal is to avoid such states, making these moves undesirable.
; PuzzleState > PuzzleState ; determine whether the final state is reachable from the given state ; generative create search tree of possible boat rides ; termination ??? (checkexpect (solve initialpuzzle) finalpuzzle) (define (solve state0) (local (; [Listof PuzzleState] > PuzzleState ; generative generate the successor states for all intermediate ones (define (solve* los) (cond [(ormap final? los) (first (filter final? los))] [else (solve* (createnextstates los))]))) (solve* (list state0))))
Clearly, solve is quite generic. As long as you define a collection of PuzzleStates, a function for recognizing final states, and a function for creating all “successor” states, solve can work on your puzzle.
Exercise 522. The solve* function generates all states reachable with n boat trips before it looks at states that require n + 1 boat trips, even if some of those boat trips return to previously encountered states. Because of this systematic way of traversing the tree, solve* cannot go into an infinite loop. Why?
Terminology This way of searching a tree or a graph is dubbed breadthfirst search.
Exercise 523. Develop a data representation for the states of the missionaryandcannibal puzzle. Like the graphical representation, a state must obviously record the number of missionaries and cannibals on each side of the river plus the location of the boat. After all, these are the properties of the world that change with one boat trip.
The description of PuzzleStates calls for a structure type definition. Represent the above initial, intermediate, and final states in your chosen data representation.
Design the function final?, which detects whether in a given state all people are on the right river bank.
Design the function rendermc, which maps a state of the missionaryandcannibal puzzle to an image.
The problem is that returning the final state says nothing about how the player can get from the initial state to the final one. In other words, createnextstates forgets how it gets to the returned states from the given ones. And this situation clearly calls for an accumulator, but at the same time, the accumulated knowledge is best associated with the individual PuzzleStates not solve* or any other function.
Exercise 524. Modify the data representation from exercise 523 so that each state records the sequence of states traversed to get there. Use a list of states.
Articulate and write down an accumulator statement with the data definition that explains the additional field.
Do you have to modify final? or rendermc to work on this revised data representation?
Exercise 525. Design the createnextstates function. It consumes lists of missionaryandcannibal states and generates the list of all those states that a boat ride can reach.
Ignore the accumulator in the first draft of createnextstates, but make sure that the function does not generate states where the cannibals can eat the missionaries.
For the second design, update the accumulator field in the state structures and use it to rule out states that have been encountered on the way to the current state.
Exercise 526. Exploit the accumulatororiented data representation to modify solve. The revised function produces the list of states that lead from the initial puzzle state to the final one.
Also consider creating a movie from this list, using rendermc to generate the images. Use runmovie to display the movie.
38.3 Accumulators as Results
The given problem is a triangle. When the triangle is too small to be subdivided any further, the algorithm does nothing; otherwise, it finds the midpoints of its three sides and deals with the three outer triangles recursively.
Sample Problem Design the addsierpinski function. It consumes an image and three Posns describing a triangle. It adds to this given image a Sierpinski triangle whose outer perimeter is the given triangle.
The given problem is trivial if the triangle is too small to be subdivided.
In the trivial case, the function returns the given image.
Otherwise the process adds the triangle and determines the midpoints of the given triangle’s sides. Each “outer” triangle is then processed recursively.
Each of these recursive steps produces an image. The remaining question is how to combine these images.
; Image Posn Posn Posn > Image ; generative adds the triangle (a, b, c) to s, subdivides the triangle ; into three by taking the midpoints of its sides, and deals ; with the outer triangles recursively until it is too small (define (addsierpinski scene0 a b c) (cond [(toosmall? a b c) scene0] [else (local ((define scene1 (addtriangle scene0 a b c)) (define midab (midpoint a b)) (define midbc (midpoint b c)) (define midca (midpoint c a)) (define scene2 (addsierpinski scene0 a midab midca)) (define scene3 (addsierpinski scene0 b midbc midab)) (define scene4 (addsierpinski scene0 c midca midbc))) (... scene0 ... scene1 ... scene2 ... scene3 ...))]))
; Image Posn Posn Posn > Image ; add the black triangle a, b, c to scene (define (addtriangle scene a b c) scene) ; Posn Posn Posn > Boolean ; is the triangle a, b, c too small tp be divided further (define (toosmall? a b c) #false) ; Posn Posn > Posn ; determine the midpoint between a and b (define (midpoint a b) a)
Now that we have all the auxiliary functions, it is time to return to the problem of combining the three images that are created by the recursive calls. One obvious guess is to use the overlay or underlay function, but a test at in the interaction area of DrRacket shows that the functions hide the underlying triangles.
> scene1 > scene2 > scene3
; Image Posn Posn Posn > Image ; generative adds the triangle (a, b, c) to s, subdivides the triangle ; into three by taking the midpoints of its sides, and deals ; with the outer triangles recursively until it is too small ; accumulator the function accumulates the triangles in the given scene (define (addsierpinski scene0 a b c) (cond [(toosmall? a b c) scene0] [else (local ((define scene1 (addtriangle scene0 a b c)) (define midab (midpoint a b)) (define midbc (midpoint b c)) (define midca (midpoint c a)) (define scene2 (addsierpinski scene1 a midab midca)) (define scene3 (addsierpinski scene2 b midbc midab))) (addsierpinski scene3 c midca midbc))]))
Figure 159 shows the reformulation based on this insight. The three highlights pinpoint the key design idea. All concern the case when the triangle is sufficiently large and it is added to the given scene. Once its sides are subdivided, the first outer triangle is recursively processed using scene1, the result of adding the given triangle. Similarly, the result of this first recursion, dubbed scene2, is used for the second recursion, which is about processing the second triangle. Finally, scene3 flows into the third recursive call. In sum, the novelty is that the accumulator is simultaneously an argument, a medium for collecting knowledge, and the result of the function.
(define MT (emptyscene 400 400)) ; the three starting Posns (define A (makeposn 200 50)) (define B (makeposn 27 350)) (define C (makeposn 373 350))
Exercise 528. To compute the endpoints of an equilateral Sierpinski triangle, draw a circle and pick three points on the circle that are 120 degrees apart, for example, 120, 240, and 360.
(define CENTER (makeposn 200 200)) ; a Posn locating the center point (define RADIUS 200) ; the radius, in terms of pixels ; Number > Posn ; determines the point on the circle with CENTER and ; RADIUS whose angle is ; examples ; given: 120/360, what are the x and ycoordinates of the desired point ; given: 240/360, what are the x and ycoordinates of the desired point ; given: 360/360, what are the x and ycoordinates of the desired point (define (circlept factor) (makeposn 0 0))
Design the function addsavannah. The function consumes an image and four numbers: (1) the xcoordinate of a line’s base point, (2) the ycoordinate of a line’s base point, (3) the length of the line, and (4) the angle of the line. It adds a fractal Savannah tree to the given image.
Unless the line is too short, the function adds the specified line to the image. It then divides the line into three segments. It recursively uses the two intermediate points as the new starting points for two lines. The lengths and the angles of the two branches change in a fixed manner, but independently of each other. Use constants to define these changes and work with them until you like your tree well enough.
Hint Experiment with shortening the left branches by at least one third and rotating it left by at least 0.15 degrees. For the right branch, shorten it by at least 20% and rotate it by 0.2 degrees in the opposite direction.
Now turn to the image in the middle It explains the essential idea of the generative step. The algorithm determines the midpoint on the two observer lines, AB and BC, as well as the midpoint between these two, ABC.
Finally, the rightmost image shows how these three new points generate two distinct recursive calls: one deals with the new triangle on the left and the other one with the triangle on the right. More precisely, AB and BC become the new observer points and the lines from A to ABC and from C to ABC become the foci of the two recursive calls.
When the triangle is small enough, we have a trivially solvable case. The algorithm just draws the triangle, and it appears as a point on the given image. You may need to experiment with the notion of “small enough” to make the curve look smooth.
39 Summary
The first step is to recognize the need for introducing an accumulator. Traversals “forget” pieces of the argument when they step from piece to the next. If you discover that such knowledge could simplify the function’s design, consider introducing an accumulator. The first step is to switch to the accumulator template.
The second, and key, step is to formulate an accumulator statement. Concisely put, the statement must express what knowledge the accumulator gathers using what kind of data. Don’t proceed until you have answered these questions. In most cases, the accumulator statement describes the relevant difference between the very original argument and the current argument.
The third step, a minor one, is to deduce from the accumulator statement (1) what the initial accumulator value is, (2) how to maintain it during traversal steps, and (3) how to exploit its knowledge.
The idea of accumulating knowledge is ubiquitous, and it appears in many different forms and shapes. It is widely used in socalled functional languages like ISL+. Programmers using imperative languages encounter accumulators in a different way, mostly via assignment statements in primitive looping constructs, because the latter cannot return values. Designing such imperative accumulator programs proceeds just like the design of accumulator functions here, but the details are beyond the scope of this first book on systematic program design.