|
From: | Eric H. Neilsen, Jr. |
Subject: | Re: [Orgmode] Re: Literate Programming with Org mode |
Date: | Wed, 29 Jul 2009 17:16:10 -0500 |
User-agent: | Thunderbird 2.0.0.22 (X11/20090625) |
Sam, sam kleinman wrote: ...
Here's a literate programing example:This is how it is often used in R (or S), and is compatible with the original idea, which is a little broader. The idea is to write a full software application by first writing a document about its design and implementation (in whatever organization is clearest for humans), but at a high enough level of detail that *all* code in *all* source files in the final application gets included somewhere in code snippets within the documentation. To compile your program, you run a program to "tangle" your text into C files, makefiles, or whatever is appropriate, and then compile that (with no additional editing).I talked with a statistician, programer and human rights violation researcher, who wrote (with his team) reports of statistical studies of data regarding possible genocide incidents. He wrote the LaTeX documents which, within the text of the document, all values and analysis' were called in and generated when LaTeX ran, so that as data was collected, and the report was recompiled the analysis was completed with the most up-to-date version of the data, and that the production of the text was isolated from the collection of data, andfrom the analysis of those figures.The stack itself, was comprised of Sweave <http://www.stat.umn.edu/~charlie/Sweave/> R for stats processing,make, and a little bit of python for glue. I think.
See http://www.literateprogramming.com/Every time I have tried this, I have given up in frustration at the tools. I have put together some org code to do it, and have used it successfully for some small projects, but I am still pulling my hair out on being able to properly contribute it to org, and it would need to be reworked in light of other developments anyway. org-babel now has includes literate programming in it as well, but I have not yet experimented with it (but am very interested in trying).
-Eric -- Eric H. Neilsen, Jr. http://home.fnal.gov/~neilsen
[Prev in Thread] | Current Thread | [Next in Thread] |