*[Update 24.08.12: added missing alias following comment by brobar]*

Whenever I write numerical code I spend half my time debugging my algebra, painstakingly uncovering one sign mistake after another in my calculations. Usually I have computed by hand the gradient or the integral of some nasty function, and I have to check it against a numerical estimate (for example returned by the wonderful numDeriv package). I have written a small utility called **cmpplot**, for “comparison plot”, that allows me to quickly plot what I’m getting from my hand-computed function against what I should be getting (the numerical estimate). It’s rather useful if you need to diagnose sign mistakes, forgotten factors, etc. It’s too small to be a R package so I’m just going to put the code below, with an example.

Let’s say that after lengthy calculations we have decided that the derivative of cos(x) is sin(x):

fun <- function(x) cos(x) dfun <- function(x) sin(x)

Although quite confident in our result, we decide to check against a numerical derivative anyway:

require(numDeriv) xv <- seq(0,2*pi,l=100) d.num <- sapply(xv,function(v) grad(fun,v)) d.th <- dfun(xv)

A call to** cmpplot** reveals an embarassing mistake:

cmpplot(d.num,d.th)

The points should all fall on the diagonal line, and most obviously they don’t.** cmpplot** also displays the result of a regression of d.th on d.num, which tells us we’ve made a sign mistake and that the derivative of cos(x) is actually -sin(x).

Sometimes a function is only correct for some arguments: for example

fun <- function(x) sign(x)*x^2 dfun <- function(x) 2*x ##WRONG for x < 0

in cases like this calling cmpplot with argument “type = 2” provides a better way of visualising what’s going on:

cmpplot(d.num,d.th,type=2)

The black dots should all align with the blue dots and only half of them do so.

**cmpplot** also has methods for matrices: this time we take cos(x) as a function that takes a vector argument and returns a vector argument, and we want to compute its Jacobian. Again we have made a mistake in our theoretical calculations:

fun <- function(x) cos(2*x) Jfun <- function(x) -diag(sin(2*x))

Checking against a numerical Jacobian:

<pre>x <- rnorm(10) J.num <- jacobian(fun,x) J.th <- Jfun(x) cmpplot(J.th,J.num)

**cmpplot** produces an image plot of the absolute error, and we see that we have made a mistake on the diagonal.

Other options include:

cmpplot(J.th,J.num,type=2)

to plot just the eigen- or singular values of the two matrices and

cmpplot(J.th,J.num,flatten=T)

to treat the matrices as vectors.

Here’s the full code for cmpplot, just copy and paste!

#Comparison Plots #Some visual tools to compare what you got and what you should be getting #Simon BarthelmÃ© (University of Geneva), 2012 cmpplot <- function(x,...) UseMethod("cmpplot",x) cmpplot.matrix <- function(A,B,flatten=F,type=1,...) { name.a <- deparse(substitute(A)) name.b <- deparse(substitute(B)) if (flatten) { cmpplot.numeric(as.numeric(A),as.numeric(B),type=type,...) } else { if (type == 1) { A <- Matrix(A) B <- Matrix(B) ttl <- sprintf("Absolute difference between %s and %s",name.a,name.b) image(abs(A-B),sub=ttl,colorkey=T) } else if (type == 2) { if (is.symmetric(A) & is.symmetric(B)) { sym <- T vA <- eigen(A)$val vB <- eigen(B)$val ylab <- "Eigenvalue" } else { sym <- F vA <- svd(A)$d vB <- svd(B)$d ylab <- "Singular value" } ttl <- sprintf('Spectrum of %s vs. spectrum of %s',name.a,name.b) ind <- 1:length(vA) ylim <- range(c(vA,vB)) plot(ind,vA,ylim=ylim,pch=20,xlab="Index",ylab=ylab,main=ttl) points(ind,vB,pch=3,col="red") legend("topright",c(name.a,name.b),pch=c(20,3),col=c('black','blue'),fill="white") } } } cmpplot.numeric <- function(a,b,type=1,stretch=F) { name.a <- deparse(substitute(a)) name.b <- deparse(substitute(b)) if (type==1) { if (stretch) { xlim <- range(c(a,b)) ylim <- xlim } else { xlim <- range(a) ylim <- range(b) } plot(a,b,xlab=name.a,ylab=name.b,xlim=xlim,ylim=ylim,col="blue",pch=20) abline(0,1) m <- lm(b ~ a) msg <- sprintf('Regression line: y = %.2f * x + %.2f',coef(m)[2],coef(m)[1]) mtext(msg) } else if (type == 2) { ylim <- range(c(a,b)) plot(a,xlab="Index",ylab="Value",pch=20,ylim=ylim) pointsb(b,pch=3) legend("topright",c(name.a,name.b),pch=c(20,3),col=c('black','blue'),bg="white") } else if (type == 3) { a <- rank(a);b <- rank(b); name.a <- paste(name.a,"(rank)") name.b <- paste(name.b,"(rank)") plot(a,b,xlab=name.a,ylab=name.b) abline(0,1) } } is.symmetric <- function(A) { if (nrow(A) == ncol(A)) { all(A==t(A)) } else { FALSE } } pointsb <- function(...) { points(...,col="blue") }

i have a question.

when i entered ” cmpplot(d.num,d.th) “, i found this message:

‘ error: function “cmpplot” is not found ‘

??cmpplot and help(cmpplot) also do not help for me.

could i know what i have to do?

thanks for your post.

cmpplot is pasted right above your comment

Nice function, thanks for sharing.

Is ‘Matrix’ and alias you have for ‘matrix’, or ‘as.matrix’ ? I changed ‘Matrix’ to ‘matrix’ and it seems to work the same.

And there is a typo in cmpplot: ‘pointsb’ should be ‘points’

Corrected, thanks a lot! Matrix is the generic class in the “Matrix” package, which has a bunch of very useful methods for special matrices (esp. sparse ones).