## Lisp-style Generic Functions in JavascriptOctober 28th, 2013 Patrick Stein

I have been spending some time over at codewars.com. It is an interactive platform where you can train on Javascript, Coffeescript, or Ruby exercises. The other participants in the site add their own exercises.

I just added an exercise to implement Lisp-style Generic Functions (including the standard method combinations) in Javascript. I’m pretty happy with the way my code came out.

var append = defgeneric('append');
append.defmethod('Array,Array', function (a,b) { return a.concat(b); });
append.defmethod('*,Array', function (a,b) { return [a].concat(b); });
append.defmethod('Array,*', function (a,b) { return a.concat([b]); });

append([1,2],[3,4]); // => [1,2,3,4]
append(1,[2,3,4]);   // => [1,2,3,4]
append([1,2,3],4);   // => [1,2,3,4]
append(1,2,3,4);     // => throws "No method found for append with args: number,number,number,number

Here’s a link directly to the exercise, but if you register for the site with this link, I get bonus points.

## Lines Are Big CirclesSeptember 13th, 2013 Patrick Stein

In previous posts here, I described using Clifford algebras for representing points and rotations. I was never very satisfied with this because the translations were still tacked on rather than incorporated in the algebra. To represent geometric objects, you need to track two Clifford multivectors: one for the orientation and another for the offset.

About two weeks ago, I found David Hestenes’s paper Old Wine in New Bottles: A new algebraic framework for computational geometry. In that paper, he describes a way to use Clifford Algebras to unify the representation of points, lines, planes, hyperplanes, circles, spheres, hyperspheres, etc. This was a big bonus. By using a projective basis, we can unify the orientation and offset. By using a null basis, we can bring in lines, planes, hyperplanes, circles, spheres, and hyperspheres.

The null basis ends up giving you a point at infinity. Every line goes through the point at infinity. None of the circles do. But, if you think of a line as a really, really big circle that goes through infinity, now you have unified lines and circles. Circles and lines are both defined by three points in the plane. (Technically, you can define a line with any three collinear points, but then you need to craft a point collinear to the other two. The point at infinity is collinear with every line. Further, such things could be seen as flattened circles having finite extent (diameter equal to the distance between the furthest apart of the three points) rather than an infinite line.)

So, I need to use Clifford algebras with a projective and null basis. All of the playing I previously did with Clifford algebras was using an orthonormal basis.

### What is a basis?

To make a Clifford algebra, one starts with a vector space. A vector space has a field of scalars (real numbers, usually) and vectors. You can multiply any vector by a scalar to get another vector. And, if $\alpha$ and $\beta$ are scalars and $\textbf{v}$ is a vector, then $\alpha (\beta \textbf{v}) = (\alpha \beta)\textbf{v}$. And, of course, we want $1\textbf{v} = \textbf{v}$ (in fact, even if $1\textbf{v}$ weren’t $\textbf{v}$ exactly, we’re always going to be multiplying by at least $1$, so we can recast our thinking to think about $1\textbf{v}$ any place we write $\textbf{v}$).

You can add together any two vectors to get another vector. Further, this addition is completely compatible with the scalar multiplication so that $\alpha\textbf{v} + \beta\textbf{v} = (\alpha + \beta)\textbf{v}$ and $\alpha(\textbf{v} + \textbf{w}) = \alpha\textbf{v} + \alpha\textbf{w}$. This of course means that every vector has a negative vector. Further $0\textbf{v} = 0\textbf{w}$ for all vectors $\textbf{v}$ and $\textbf{w}$. This is the distinguished vector called the zero vector. The sum of any vector $\textbf{v}$ and the zero vector is just the vector $\textbf{v}$.

Every vector space has a basis (though some have an infinite basis). A basis is a minimal subset of the vectors such that every vector vector can be written as the sum of multiples of the basis vectors. So, if the whole basis is $\textbf{v}$ and $\textbf{w}$, then every vector can be written as $\alpha\textbf{v} + \beta\textbf{w}$. A basis is a minimal subset in that no basis element can be written as the sum of multiples of the other elements. Equivalently, this means that the only way to express the zero vector with the basis is by having every basis element multiplied by the scalar zero.

### Okay, but what is an orthonormal basis?

You need more than just a vector space to make a Clifford algebra. You need either a quadratic form or a dot-product defined on the vectors.

A quadratic form on a vector is a function $Q$ that takes in a vector and outputs a scalar. Further, $Q(\alpha\textbf{v}) = \alpha^2 Q(\textbf{v})$ for all scalars $\alpha$ and all vectors $\textbf{v}$.

A dot product is a function $\langle\cdot{},\cdot{}\rangle$ that takes two vectors and outputs a scalar. A dot product must be symmetric so that $\langle\textbf{v},\textbf{w}\rangle = \langle\textbf{w},\textbf{v}\rangle$ for all vectors $\textbf{v}$ and $\textbf{w}$. Furthermore, the dot product must be linear in either term. (Since it’s symmetric, it suffices to require it be linear in either term.) This means that for all scalars $\alpha$ and $\beta$ and all vectors $\textbf{v}$, $\textbf{w}$, and $\textbf{x}$ then $\langle\alpha\textbf{v}+\beta\textbf{w},\textbf{x}\rangle = \alpha\langle\textbf{v},\textbf{x}\rangle + \beta\langle\textbf{w},\textbf{x}\rangle$.

From any dot product, you can make a quadratic form by saying $Q(\textbf{x}) = \langle\textbf{x},\textbf{x}\rangle$ $\textbf{}$. And, so long as you’re working with scalars where one can divide by two (aka, almost always), you can make a dot product from a quadratic form by saying $\langle\textbf{x},\textbf{y}\rangle = \frac{1}{2}(Q(\textbf{x}+\textbf{y}) - Q(\textbf{x}) - Q(\textbf{y})$. So, it doesn’t really matter which you have. I’m going to freely switch back and forth between them here for whichever is most convenient for the task at hand. I’ll assume that I have both.

So, let’s say we have a dot product on our vector space. What happens when we take the dot product on pairs of our basis vectors? If $\textbf{v}$ and $\textbf{w}$ are distinct elements of our basis with $\langle\textbf{v},\textbf{w}\rangle = 0$ $\textbf{}$, then $\textbf{v}$ and $\textbf{w}$ are said to be orthogonal (basis elements). If every element of the basis is orthogonal to every other basis element, then we have an orthogonal basis.

We say a basis element $\textbf{v}$ is normalized if $\langle\textbf{v},\textbf{v}\rangle = \pm 1$. If all of the basis vectors are normalized, we have a normal basis.

An orthonormal basis is a basis that’s both an orthogonal basis and a normal basis.

You can represent any dot product as a symmetric matrix $A$. To find $\langle\textbf{v},\textbf{w}\rangle$, you multiply $\textbf{v}^TA\textbf{w}$. Further, you can always decompose a scalar matrix into the form $A = S D S^T$ where $D$ is a diagonal matrix (a matrix where all of the elements off of the diagonal are zero) and $S^T = S^{-1}$. Because of that, you can always find an orthogonal basis for a vector space. So, with just a little bit of rotating around your original choice of basis set, you can come up with a different basis that is orthogonal.

If your orthogonal basis is not normalized, you can (almost always) normalize the basis vectors where $Q(\textbf{v}) \ne 0$ by dividing it by the square root of $Q(\textbf{v})$. If any of the elements on the diagonal in the diagonal matrix are zero, then you didn’t have a minimal set for a basis.

So, as long as you can divide by square roots in whatever numbers system you chose for your scalars, then you can find an orthonormal basis. That means that $Q(\textbf{v})$ is either $+1$ or $-1$ for every basis vector $\textbf{v}$. It also means (going back to dot product) that $\langle\textbf{v},\textbf{w}\rangle = 0$ for distinct basis vectors $\textbf{v}$ and $\textbf{w}$.

You can also re-order your basis set so that all of the $Q(\textbf{v}) = +1$ vectors come first and all of the $Q(\textbf{v}) = -1$ vectors are last. So, much of the literature on Clifford algebras (and all of the stuff that I had done before with them) uses such a basis. If the field of scalars is the real numbers $\mathbb{R}$, then we abbreviate the Clifford algebra as $\mathcal{C}\ell_{p,q}$ when there are $p$ basis vectors where $Q(\textbf{v}) = +1$ and $q$ basis vectors where $Q(\textbf{v}) = -1$.

### What about Projective and Null?

I mentioned at the outset that the Hestenes paper uses a projective basis that’s also a null basis. If you’ve done any geometry in computers before you have probably bumped into projective coordinates. If you have a 3d-vector $[x,y,z]^T$ then you turn it into a projective coordinate by making it a 4d-vector that ends with $1$ giving you $[x,y,z,1]^T$. Now, you take your three by three rotation matrices and extend them to four by four matrices. This lets you incorporate rotations and translations into the same matrix instead of having to track a rotation and an offset.

What about a null basis though? With a null basis, $Q(\textbf{v}) = 0$ for each (some?) of the basis vectors. The key point for me here is that the matrix representing the dot product isn’t diagonal. As an easy example, if we have a basis with two basis vectors $\textbf{v}$ and $\textbf{w}$, then we can represent any vector $\textbf{x}$ as $\alpha\textbf{v} + \beta\textbf{w}$. If we have $Q(x) = \alpha^2 - \beta^2$, then that is an orthonormal basis (with $Q(\textbf{v}) = +1$ and $Q(\textbf{w}) = -1$). If we picked two different basis vectors $\textbf{v}^\prime$ and $\textbf{w}^\prime$ then we would represent $\textbf{x}$ as $\alpha^\prime\textbf{v}^\prime + \beta^\prime\textbf{w}^\prime$. We could pick them so that $Q(\textbf{x}) = 2\alpha^\prime\beta^\prime$. This would be a null basis because $Q(\textbf{v}^\prime) = Q(\textbf{w}^\prime) = 0$.

### Clifford Algebras with an Orthonormal Basis

Once you have a vector space and a quadratic form or dot product, then you make a Clifford algebra by defining a way to multiply vectors together. For Clifford algebras, we insist that when we multiply a vector $\textbf{v}$ by itself, the result is exactly $Q(\textbf{v})$. Then, we go about building the biggest algebra we can with this restriction.

Let’s look at what happens when we have two vectors $\textbf{v}$ and $\textbf{w}$. Our Clifford restriction means that $(\textbf{v}+\textbf{w})^2 = Q(\textbf{v}+\textbf{w})$. We want multiplication to distribute with addition just like it does in algebra so the left hand side there should be: $\textbf{v}^2 + \textbf{vw} + \textbf{wv} + \textbf{w}^2$. Note: we haven’t yet assumed that our multiplication has to be commutative, so we can’t reduce that to $\textbf{v}^2 + 2 \textbf{vw} + \textbf{w}^2$.

Remember, now, the connection between the quadratic form $Q$ and the dot product $\langle\cdot,\cdot\rangle$. We have, for the right hand side, that $Q(\textbf{v}+\textbf{w}) = \langle\textbf{v}+\textbf{w},\textbf{v}+\textbf{w}\rangle$. Now, we use the fact that the dot product is linear in both terms to say that $\langle\textbf{v}+\textbf{w},\textbf{v}+\textbf{w}\rangle = \langle\textbf{v},\textbf{v}\rangle + \langle\textbf{v},\textbf{w}\rangle + \langle\textbf{w},\textbf{v}\rangle + \langle\textbf{w},\textbf{w}\rangle$. Using the connection to the quadratic form again and the fact that the dot product is symmetric, we can simplify that to $Q(\textbf{v}) + 2\langle\textbf{v},\textbf{w}\rangle + Q(\textbf{w})$.

Because $v^2 = Q(\textbf{v})$ and $w^2 = Q(\textbf{w})$, we can simplify our original equation $(\textbf{v}+\textbf{w})^2 = Q(\textbf{v}+\textbf{w})$ to be $\textbf{vw} + \textbf{wv} = 2\langle\textbf{v},\textbf{w}\rangle$.

If $\textbf{v} = \textbf{w}$, then the above reduces to the definitional $\textbf{v}^2 = Q(v)$. If $\textbf{v}$ and $\textbf{w}$ are distinct basis vectors in our orthogonal basis, then $2\langle\textbf{v},\textbf{w}\rangle = 0$. This means that $\textbf{wv} = -\textbf{vw}$. So, our multiplication of distinct basis vectors anticommutes!

Now, given an arbitrary vector, we can express it as a sum of multiples of the basis vectors: $\textbf{v} = \alpha_1\textbf{e}_1 + \alpha_2\textbf{e}_2 + ...$ where the $\alpha_i$ are all scalars and the $\textbf{e}_i$ are all basis vectors in our orthogonal basis. Given two such vectors we can do all of the usual algebraic expansion to express the product of the two vectors as a sum of multiples of products of pairs of basis vectors. Any place where we end up with $\textbf{e}_i\textbf{e}_i$ we can replace it with the scalar number $Q(\textbf{e}_i)$. Any place we end up with $\textbf{e}_i\textbf{e}_j$ with $i < j$, we can leave it as it is. Any place we end up with $\textbf{e}_j\textbf{e}_i$ with $i < j$, we can replace it with $-\textbf{e}_i\textbf{e}_j$. Then, we can gather up like terms.

So, suppose there were two vectors in our orthonormal basis $\textbf{e}_1$ and $\textbf{e}_2$. And, assume $Q(\textbf{e}_1) = +1$ and $Q(\textbf{e}_2) = -1$. Then $(a\textbf{e}_1 + b\textbf{e}_2)(c\textbf{e}_1 + d\textbf{e}_2)$ expands out to $ac\textbf{e}_1^2 + ad\textbf{e}_1\textbf{e}_2 + bc\textbf{e}_2\textbf{e}_1 + bd\textbf{e}_2^2$. We can then manipulate that as outlined in the previous paragraph to whittle it down to $(ac-bd) + (ad-bc)\textbf{e}_1\textbf{e}_2$.

We still don’t know what $\textbf{e}_1\textbf{e}_2$ is exactly, but we’re building a big-tent algebra here. We don’t have a restriction that says it has to be something, so it gets to be its own thing unless our restrictions hold it back. How big is our tent going to be? Well, let’s see what happens if we multiply $\textbf{e}_1\textbf{e}_2$ by other things we already know about.

What happens if we multiply $\textbf{e}_1(\textbf{e}_1\textbf{e}_2)$? We want our multiplication to be associative. So, $\textbf{e}_1(\textbf{e}_1\textbf{e}_2) = \textbf{e}_1^2\textbf{e}_2$ and because $\textbf{e}_1^2 = 1$, this is just $\textbf{e}_1(\textbf{e}_1\textbf{e}_2) = \textbf{e}_2$. Well, what if we had multiplied in the other order? $(\textbf{e}_1\textbf{e}_2)\textbf{e}_1 = -(\textbf{e}_2\textbf{e}_1)\textbf{e}_1 = -\textbf{e}_2\textbf{e}_1^2 = -\textbf{e}_2$. Interesting. By similar reasoning, $\textbf{e}_2(\textbf{e}_1\textbf{e}_2) = -\textbf{e}_2^2\textbf{e}_1 = \textbf{e}_1$ and $(\textbf{e}_1\textbf{e}_2)\textbf{e}_2 = \textbf{e}_1\textbf{e}_2^2 = -\textbf{e}_1$.

What happens if we multiply $(\textbf{e}_1\textbf{e}_2)(\textbf{e}_1\textbf{e}_2)$. This is just a combination of the above sorts of things and we find that

$(\textbf{e}_1\textbf{e}_2)^2 = -(\textbf{e}_2\textbf{e}_1)(\textbf{e}_1\textbf{e}_2) = -\textbf{e}_2(\textbf{e}_1^2)\textbf{e}_2 = -\textbf{e}_2^2 = 1$

So, that’s as big as our tent is going to get with only two vectors in our orthonormal basis.

Our Clifford algebra then has elements composed of some multiple of the scalar $1$ plus some multiple of $\textbf{e}_1$ plus some multiple of $\textbf{e}_2$ plus some multiple of $\textbf{e}_1\textbf{e}_2$. If we had added a third basis vector $\textbf{e}_3$, then we also get $\textbf{e}_1\textbf{e}_3$, $\textbf{e}_2\textbf{e}_3$, and $\textbf{e}_1\textbf{e}_2\textbf{e}_3$. In general, if you have $n$ vectors in the basis of the vector space, then there will be $2^n$ basis elements in the corresponding Clifford algebra.

You can rework any term $\alpha\textbf{e}_i\textbf{e}_j\textbf{e}_k...$ so that the subscripts of the basis vectors are monotonically increasing by swapping adjacent basis vectors with differing subscripts changing the sign on $\alpha$ at the same time. When you have two $\textbf{e}_i$ side-by-side with the same subscript, annihilate them and multiply the coefficient $\alpha$ by $Q(e_i)$ (which was either $+1$ or $-1$). Then, you have a reduced term $\pm\alpha\textbf{e}_i\textbf{e}_j...$ where the subscripts are strictly increasing.

### What Happens When You Don’t Have An Orthonormal Basis?

The Hestenes paper doesn’t use an orthonormal basis. I’d never played with Clifford algebras outside of one. It took me about two weeks of scrounging through text books and information about something called the contraction product and the definitions of Clifford algebras in terms of dot-products plus something called the outer product (which gives geometric meaning to our new things like $\textbf{e}_1\textbf{e}_2$).

I learned a great deal about how to multiply vectors, but I didn’t feel that much closer to being able to multiply $\textbf{e}_1\textbf{e}_4\textbf{e}_3\textbf{e}_1$ unless the basis was orthonormal. I felt like I’d have to know things like the dot product of a vector with something like $\textbf{e}_4\textbf{e}_3\textbf{e}_1$ and then somehow mystically mix in the contraction product and extend by linearity.

There’s a whole lot of extending by linearity in math. In some cases, I feel like extending by linearity leaves me running in circles. (To go with the theme, sometimes I’m even running in a really big circle through the point at infinity.) We did a bit of extending by linearity above when we went from $\textbf{v}^2 = Q(\textbf{v})$ into what $(\textbf{v}+\textbf{w})^2$ must be based on the linearity in the dot product.

Finally, something clicked for me enough to figure out how to multiply $\textbf{e}_1\textbf{e}_4\textbf{e}_3\textbf{e}_1$ and express it as a sum of terms in which the basis vectors in each term had increasing subscripts. Now that it has clicked, I see how I should have gone back to one of our very first equations: $\textbf{vw} + \textbf{wv} = 2\langle\textbf{v},\textbf{w}\rangle$. With our orthogonal basis, $\langle\textbf{v},\textbf{w}\rangle$ was always zero for distinct basis vectors.

If we don’t have an orthogonal basis, then the best we can do is $\textbf{wv} = 2\langle\textbf{v},\textbf{w}\rangle - \textbf{vw}$. That is good enough. Suppose then we want to figure out $\textbf{e}_1\textbf{e}_4\textbf{e}_3\textbf{e}_1$ so that none of the terms have subscripts out of order. For brevity, let me write $d_{i,j}$ to mean $\langle\textbf{e}_i,\textbf{e}_j\rangle$. The first things we see out of order are $\textbf{e}_4$ and $\textbf{e}_3$. To swap those, we have to replace $\textbf{e}_4\textbf{e}_3$ with $d_{3,4} - \textbf{e}_3\textbf{e}_4$. Now, we have $\textbf{e}_1 ( 2d_{3,4} - \textbf{e}_3\textbf{e}_4 ) \textbf{e}_1$. With a little bit of algebra, this becomes $2d_{3,4}\textbf{e}_1^2 - \textbf{e}_1\textbf{e}_3\textbf{e}_4\textbf{e}_1 = 2d_{3,4}d_{1,1} - \textbf{e}_1\textbf{e}_3\textbf{e}_4\textbf{e}_1$. That last term is still not in order, so we still have more to do.

$\begin{array}{c}2d_{3,4}d_{1,1} - \textbf{e}_1\textbf{e}_3\textbf{e}_4\textbf{e}_1 \\2d_{3,4}d_{1,1} - \textbf{e}_1\textbf{e}_3(2d_{1,4} - \textbf{e}_1\textbf{e}_4) \\2d_{3,4}d_{1,1} - 2d_{1,4}\textbf{e}_1\textbf{e}_3 + \textbf{e}_1\textbf{e}_3\textbf{e}_1\textbf{e}_4 \\2d_{3,4}d_{1,1} - 2d_{1,4}\textbf{e}_1\textbf{e}_3 + \textbf{e}_1(2d_{1,3} - \textbf{e}_1\textbf{e}_3)\textbf{e}_4 \\2d_{3,4}d_{1,1} - 2d_{1,4}\textbf{e}_1\textbf{e}_3 + 2d_{1,3}\textbf{e}_1\textbf{e}_4 - \textbf{e}_1^2\textbf{e}_3\textbf{e}_4 \\2d_{3,4}d_{1,1} - 2d_{1,4}\textbf{e}_1\textbf{e}_3 + 2d_{1,3}\textbf{e}_1\textbf{e}_4 - d_{1,1}\textbf{e}_3\textbf{e}_4\end{array}$

Whew. Now, to get that into code.

### 26 SLOC

In the end, I ended up with this 26 SLOC function that takes in a matrix dots to represent the dot product and some number of ordered lists of subscripts and returns a list of scalars where the scalar in spot $i$ represents the coefficient in front of the ordered term where the $k$-th basis vector is involved if the $(k-1)$-th bit of $i$ is set. So, for the example we just did with the call (basis-multiply dots '(1 4) '(3) '(1)), the zeroth term in the result would be $2d_{3,4}d_{1,1}$. The fifth term ($(2^2 + 2^0)$-th term) would be $-2d_{1,4}$. The ninth term would be $2d_{1,3}$. The twelfth term would be $-d{1,1}$. The rest of the terms would be zero.

From this, I will be able to build a function that multiplies arbitrary elements of the Clifford algebra. Getting to this point was the hard part for me. It is 26 SLOC that took me several weeks of study to figure out how to do on paper and about six hours of thinking to figure out how to do in code.

(defun basis-multiply (dots &rest xs)
(let ((len (expt 2 (array-dimension dots 0))))
(labels ((mul (&rest xs)
(let ((xs (combine-adjacent (remove nil xs))))
(cond
((null xs)
(vec len 0))

((null (rest xs))
(vec len (from-bits (first xs))))

(t
(destructuring-bind (x y . xs) xs
(let ((a (first (last x)))
(b (first y))
(x (butlast x))
(y (rest y)))
(if (= a b)
(combine-like x a y xs)
(swap-ab x a b y xs))))))))

(dot (a b)
(aref dots (1- a) (1- b)))

(combine-like (x a y xs)
;; X e1 e1 Y ... = (e1.e1) X Y ...
(vs (dot a a) (apply #'mul x y xs)))

(swap-ab (x a b y xs)
;; X e2 e1 Y ... = 2(e1.e2) X Y ... - X e1 e2 Y ...
(v- (vs (* 2 (dot a b)) (apply #'mul x xs))
(apply #'mul x (list b a) y xs))))
(apply #'mul xs))))

I had one false start on the above code where I accidentally confounded the lists that I was using as input with the lists that I was generating as output. I had to step back and get my code to push all of the work down the call stack while rolling out the recursion and only creating new vectors during the base cases of the recursion and only doing vector subtractions while unrolling the recursion.

There are also 31 SLOC involved in the combine-adjacent function (which takes a list like ((1 2 3) nil (4 5) (3)) and removes the nils then concatenates consecutive parts that are in order already to get ((1 2 3 4 5) (3))), the vec function (which makes a vector of a given length with a non-zero coefficient in a given location), the from-bits function (which turns a list of integers into a number with the bit $k$ set if $k+1$ is in the list) and the little functions like vs and v- (which, respectively, scale a list of numbers by a factor and element-wise subtract two lists).

The 31 supporting SLOC were easy though. The 26 SLOC shown above represent the largest thought-to-code ratio of any code that I’ve ever written.

WO0T!!!t!1! or something!

Now, to Zig this SLOC for Great Justice!

## The Bowling Game Kata in Functional Common LispAugust 14th, 2013 Patrick Stein

Code Kata are repetitive coding tasks designed to help one internalize certain patterns, methodologies, or tools. In this video, I go through Uncle Bob Martin’s The Bowling Game Kata. The Kata exercises test-driven development. Uncle Bob’s presentation of the Kata is in Java. This is in Common Lisp using a functional approach.

In my previous video in this series, I employed an imperative style. Here, I use a functional style where all of the data is immutable.

Git repository: https://github.com/nklein/kata

## IRC GraphsJuly 24th, 2013 Patrick Stein

For some time, I’ve been wanting to find some big data source to dig around in and make plots of. Yesterday, I realized that I have access to #lisp logs from IRC going back several years.

The first question that I wanted to look at was: How well does talkativeness on IRC follow a Power Law?

It looks pretty close when you’re looking at the raw data if you limit yourself to the top 100 to 300 people. Once you get up near the top 500 people, the best-fit curve really skyrockets way through the roof. There are just tons of speakers who have said one or two lines in the given time period. And, I made no effort to track lurkers so I have no zeros in my data set.

Here is a plot of the top 250 speakers (ranked by lines spoken). stassats is the leader, followed by pjb, then H4ns, then Xach. I made a best-effort to collate different handles for the same person (e.g. Xach_ vs. Xach). The least-squares, best-fit power-law curve here is $68435 k^{-1.0638}$. So, if we’re going to match the curve exactly, we’ll need stassats to talk more than twice as much. If you’d like to know how much more (or less) you should talk, drop me a note.

Click on the image above for the full-size version. I used optima.ppcre to read the log files and vecto to draw the graph. Here is the relevant source code: package.lisp, read.lisp, and power.lisp.

## Introduction

SICP has a few sections devoted to using a general, damped fixed-point iteration to solve square roots and then nth-roots. The Functional Programming In Scala course that I did on Coursera did the same exercise (at least as far as square roots go).

The idea goes like this. Say that I want to find the square root of five. I am looking then for some number $s$ so that $s^2 = 5$. This means that I’m looking for some number $s$ so that $s = \frac{5}{s}$. So, if I had a function $f(x) = \frac{5}{x}$ and I could find some point $s$ where $s = f(s)$, I’d be done. Such a point is called a fixed point of $f$.

There is a general method by which one can find a fixed point of an arbitrary function. If you type some random number into a calculator and hit the “COS” button over and over, your calculator is eventually going to get stuck at 0.739085…. What happens is that you are doing a recurrence where $x_{n+1} = \cos(x_n)$. Eventually, you end up at a point where $x_{n+1} = x_{n}$ (to the limits of your calculator’s precision/display). After that, your stuck. You’ve found a fixed point. No matter how much you iterate, you’re going to be stuck in the same spot.

Now, there are some situations where you might end up in an oscillation where $x_{n+1} \ne x_n$, but $x_{n+1} = x_{n-k}$ for some $k \ge 1$. To avoid that, one usually does the iteration $x_{n+1} = \mathsf{avg}(x_n,f(x_n))$ for some averaging function $\mathsf{avg}$. This “damps” the oscillation.

## The Fixed Point higher-order function

In languages with first-class functions, it is easy to write a higher-order function called fixed-point that takes a function and iterates (with damping) to find a fixed point. In SICP and the Scala course mentioned above, the fixed-point function was written recursively.

(defun fixed-point (fn &optional (initial-guess 1) (tolerance 1e-8))
(labels ((close-enough? (v1 v2)
(<= (abs (- v1 v2)) tolerance))
(average (v1 v2)
(/ (+ v1 v2) 2))
(try (guess)
(let ((next (funcall fn guess)))
(cond
((close-enough? guess next) next)
(t (try (average guess next)))))))
(try (* initial-guess 1d0))))

It is easy to express the recursion there iteratively instead if that’s easier for you to see/think about.

(defun fixed-point (fn &optional (initial-guess 1) (tolerance 1e-8))
(flet ((close-enough? (v1 v2)
(<= (abs (- v1 v2)) tolerance))
(average (v1 v2)
(/ (+ v1 v2) 2)))
(loop :for guess = (* initial-guess 1d0) :then (average guess next)
:for next = (funcall fn guess)
:until (close-enough? guess next)
:finally (return next))))

## Using the Fixed Point function to find k-th roots

Above, we showed that the square root of $n$ is a fixed point of the function $f(x) = \frac{n}{x}$. Now, we can use that to write our own square root function:

(defun my-sqrt (n)
(fixed-point (lambda (x) (/ n x)))

By the same argument we used with the square root, we can find the $k$-th root of 5 by finding the fixed point of $f(x) = \frac{5}{x^{k-1}}$. We can make a function that returns a function that does k-th roots:

(defun kth-roots (k)
(lambda (n)
(fixed-point (lambda (x) (/ n (expt x (1- k)))))))

(setf (symbol-function 'cbrt) (kth-root 3))

## Inverting functions

I found myself wanting to find inverses of various complicated functions. All that I knew about the functions was that if you restricted their domain to the unit interval, they were one-to-one and their domain was also the unit interval. What I needed was the inverse of the function.

For some functions (like $f(x) = x^2$), the inverse is easy enough to calculate. For other functions (like $f(x) = 6x^5 - 15x^4 + 10x^3$), the inverse seems possible but incredibly tedious to calculate.

Could I use fixed points to find inverses of general functions? We’ve already used them to find inverses for $f(x) = x^k$. Can we extend it further?

After flailing around Google for quite some time, I found this article by Chen, Lu, Chen, Ruchala, and Olivera about using fixed-point iteration to find inverses for deformation fields.

There, the approach to inverting $f(x)$ was to formulate $u(x) = f(x) - x$ and let $v(x) = f^{-1}(x) - x$. Then, because

$x = f(f^{-1}(x)) = f^{-1}(x) + u(f^{-1}(x)) = x + v(x) + u(x + v(x))$

That leaves the relationship that $v(x) = -u(x + v(x))$. The goal then is to find a fixed point of $v(x)$.

I messed this up a few times by conflating $f$ and $u$ so I abandoned it in favor of the tinkering that follows in the next section. Here though, is a debugged version based on the cited paper:

(defun pseudo-inverse (fn &optional (tolerance 1d-10))
(lambda (x)
(let ((iterant (lambda (v)
(flet ((u (x)
(- (funcall fn x) x)))
(- (u (+ x v)))))))
(+ x (fixed-point iterant 0d0 tolerance)))))

Now, I can easily check the average variance over some points in the unit interval:

(defun check-pseudo-inverse (fn &optional (steps 100))
(flet ((sqr (x) (* x x)))
(/ (loop :with dx = (/ (1- steps))
:with inverse = (pseudo-inverse fn)
:repeat steps
:for x :from 0 :by dx
:summing (sqr (- (funcall fn (funcall inverse x)) x)))
steps)))

(check-pseudo-inverse #'identity) => 0.0d0
(check-pseudo-inverse #'sin)      => 2.8820112095939962D-12
(check-pseudo-inverse #'sqrt)     => 2.7957469632748447D-19
(check-pseudo-inverse (lambda (x) (* x x x (+ (* x (- (* x 6) 15)) 10))))
=> 1.3296561385041381D-21

## A tinkering attempt when I couldn’t get the previous to work

When I had abandoned the above, I spent some time tinkering on paper. To find $f^{-1}(x)$, I need to find $y$ so that $f(y) = x$. Multiplying both sides by $y$ and dividing by $f(y)$, I get $y = \frac{xy}{f(y)}$. So, to find $f^{-1}(x)$, I need to find a $y$ that is a fixed point for $\frac{xy}{f(y)}$:

(defun pseudo-inverse (fn &optional (tolerance 1d-10))
(lambda (x)
(let ((iterant (lambda (y)
(/ (* x y) (funcall fn y)))))
(fixed-point iterant 1 tolerance))))

This version, however, has the disadvantage of using division. Division is more expensive and has obvious problems if you bump into zero on your way to your goal. Getting rid of the division also allows the above algorithms to be generalized for inverting endomorphisms of vector spaces (the $\mathsf{avg}$ function being the only slightly tricky part).

## Denouement

I finally found a use of the fixed-point function that goes beyond $k$-th roots. Wahoo!