Category Archives: Writing

Writing

Writing Hurts

I had forgotten how painful scientific writing is. It’s good to know, from quotes I’ve read, that many of the best writers in history have had difficulty producing written works. If they had difficulties, how can I expect it to be easy?

Scientific Writing and E-Prime

E-Prime is a modification to the English language in which the verb “to be” is not allowed. I first learned of it via Catallaxy (disclaimer: I occasionally post on Catallaxy), where Cato links to this article.

I love the idea of E-Prime. A few attempts to speak or write in it convinced me that it makes it difficult to hide assumptions. E-Prime is therefore very appropriate for scientific writing, in which it is important to clarify what assumptions were made. Unfortunately, removal of the verb “to be” causes awkward and sometimes repetitive writing, particularly in “Methods” writing. It gets rid of the passive voice, oh-so-beloved pseudo-humble writing style of many a scientist.

Normal Methods

The model was paced eight times at a basic cycle length (BCL) of 300 ms. A shock was then applied with a field perpendicular to the direction of propagation over a range of coupling intervals (CIs) following the last paced beat. Once reentry was initiated, the model was allowed to run until action potential duration (APD) stabilized to a variation of less than 1 ms per beat.

E-Prime Methods

We paced the model eight times at a basic cycle length (BCL) of 300 ms. We then applied a shock with a field perpendicular to the direction of propagation over a range of coupling intervals (CIs) following the last paced beat. Once we initiated reentry, we allowed the model to run until action potential duration (APD) stabilized to a variaition of less than 1ms per beat.


Not too awkward there, but to be is replaced by we (verb)ed, resulting in gratuitous use of the Royal We. Zeus forbid we use the first person pronoun “I” in a scientific paper. Imagine several more paragraphs of this, though — it can get annoyingly repetitive quickly.

Perhaps it is more important to focus on the use of E-Prime in results. After all, one of the best examples I’ve seen of the utility of E-Prime is in describing elementary particles (as done in the linked article):

A proton appears to behave like a particle when observed by instrument 1. A proton appears to behave like a wave when observed by instrument 2.

vs.

A proton is a particle. A proton is wave.

Even for people who are well-versed in the mathematics and various experiments used to generate the statements above, one is clearer than the other. In fact, I would go so far as to say that the E-Prime version (first one) is a set of observations, while the “to be”-inclusive version (second) is a set of (contradictory) conclusions.

Now, assuming that I want to write my papers in E-Prime, how do I buck the system in which people are used to passive voice and still get published?

Disclaimer: I did not attempt to make this post E-Prime-compliant, though this disclaimer follows the rules of E-Prime.

Boring Papers

Yet another PHD Comics episode that rings true. This is what happens when one tries to read a paper that’s more of a brain/data dump than a well-crafted exposition of research.

Tranquilizer with Graphs

I’ve found that no amount of coffee helps, and beyond a certain number of cups, I don’t actually feel tired. Instead, my brain just shuts down while awake, and 10 minutes later I snap to, realizing I’ve been staring at the page with no comprehension.

Maintaining My Posting Rate

I had one major New-Year’s resolution (though I had resolved it before then): post to my blog on average once per day. This sounds simple, but I don’t just want one post on each day. I’m happy to let my posting muse cycle between wordlessness and logorrhea. Therefore, if I post three things one day, I’m off scot free for the next two days. In practice, this gets pretty hard to keep track of. I’ve already started to find it difficult 23 days into the year.

However, I was able to remedy this with a little PHP and MySQL code. WordPress (this blogging software) runs on those technologies, and so it was trivial for me to tap into the database and produce this page. It does something very simple. It goes from the beginning of the year to the present day, tallying posts along the way, and dividing by the number of days in the year that have passed. This gives me a total post count and a ratio of posts to days. As you can see if you look at that page, I have been coasting for a little while, but was getting dangerously close to “1”. This post should remedy that, which is kind of cheating, but I’m willing to accept it.

Probably this could be dressed up into a widget or plugin or something, and anyone is welcome to use it to do that, but I have neither the time nor sufficient interest to learn how.
Here’s the PHP code, if you’re interested: postcountphp.gz (1 kB)

ADDENDUM: Updated 2008-01-26 to only count published posts.