Browse Source

expanded "* Reproducible Research" in ob-worg

Eric Schulte 16 years ago
parent
commit
c90810903d
1 changed files with 29 additions and 4 deletions
  1. 29 4
      org-babel-worg.org

+ 29 - 4
org-babel-worg.org

@@ -262,10 +262,35 @@ b + 4
 (org-babel-lob-ingest "path/to/file.org")
 #+end_src
 
-* Reproducible research
-  - output vs. value mode
-  - file & graphical output
-  - controlling export
+* Reproducible Research
+#+begin_quote 
+An article about computational science in a scientific publication is
+not the scholarship itself, it is merely advertising of the
+scholarship. The actual scholarship is the complete software
+development environment and the complete set of instructions which
+generated the figures.
+#+end_quote
+-- D. Donoho
+
+[[http://reproducibleresearch.net/index.php/Main_Page][Reproducible Research]] (RR) is the practice of distributing the data
+and functions referenced in a paper into the paper itself, so that
+each copy of the paper is not only a document describing the research,
+but is also an executable reproducing the research.
+
+Org-mode already has exceptional support for [[http://orgmode.org/manual/Exporting.html#Exporting][exporting to html and
+LaTeX]].  Org-babel makes Org-mode a tool for RR by *activating* the
+data and source code embedded into Org-mode documents making the
+entire document executable.  This makes it not only possible, but
+natural to distribute research in a format that encourages readers to
+recreate your results, and perform their own analysis.
+
+Existing RR tools like [[http://en.wikipedia.org/wiki/Sweave][Sweave]] provide for the embedding of [[http://www.r-project.org/][R]] code into
+LaTeX documents.  While this is very useful, such documents often
+still require a large degree of "glue" in the form of external shell
+scripts, python code, and Makefiles.  To my knowledge Org-babl is the
+only RR tool which allows multiple languages and data to coexist and
+cooperate inside of a single document.
+
 * Literate programming
   - org-babel-tangle
   - org-babel-load-file