forked from mirrors/org-mode
expanded "* Reproducible Research" in ob-worg
This commit is contained in:
parent
9bcc624916
commit
c90810903d
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue