expanded "* Reproducible Research" in ob-worg

This commit is contained in:
Eric Schulte 2009-08-12 08:55:42 -06:00
parent 9bcc624916
commit c90810903d

View file

@ -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