emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Eric Schulte" <schulte.eric@gmail.com>
To: sam kleinman <garen@tychoish.com>
Cc: "Sébastien Vauban" <wxhgmqzgwmuf@spammotel.com>, emacs-orgmode@gnu.org
Subject: Re: Re: Literate Programming with Org mode
Date: Fri, 31 Jul 2009 11:01:36 -0600	[thread overview]
Message-ID: <m2y6q4yefj.fsf@gmail.com> (raw)
In-Reply-To: <20090728215355.GA5609@issac.linlan> (sam kleinman's message of "Tue, 28 Jul 2009 17:53:55 -0400")

Hi Sam,

Not to be overly picky, but I think the scenario you described (while
very engaging) is an instance of Reproducible Research [1].  My
understanding of Reproducible Research and Literate Programming and
their relation is as follows...

- Literate Programming :: A style of programming in which the source
     code is a work of literature (i.e. is intended for human
     consumption) and is structured in such a way that a machine
     readable version can be automatically extracted from the primary
     document.
- Reporducable Research :: A style of publishing information in which
     the raw data and analysis are embedded in the published document
     such that the analysis can be re-run and analyzed by any reader.

I think the difference between these two is that in LP the "product" is
the executable piece of software, where as in RR the "product" is the
document itself.

Cheers -- Eric

PS: The initial goal of the org-babel suite was to implement Sweave type
functionality as part of org-mode.

sam kleinman <garen@tychoish.com> writes:

> On Tue, Jul 28, 2009 at 10:41:50PM +0200, Sébastien Vauban wrote:
>
>> I've heard that Knuth told about it in those words: it's when we will be able
>> to read the code of a software in our bed, reading a book made of 90% of
>> documentation and 10% of code. If someone can find this phrase somewhere...
>
> Here's a literate programing example: 
>
> 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, and
> from 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. 
>
> As an example. I'm not an expert either on this stuff. 
>
> Cheers,
> sam
> --
> tycho(ish) @
> garen@tychoish.com
> http://www.tychoish.com/
> http://www.criticalfutures.com/
> "don't get it right, get it written" -- james thurber
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

Footnotes: 
[1]  http://www.reproducibleresearch.org/

  parent reply	other threads:[~2009-07-31 17:01 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-07-28 16:14 Literate Programming with Org mode Sébastien Vauban
2009-07-28 16:46 ` Marcelo de Moraes Serpa
2009-07-28 20:41   ` Sébastien Vauban
2009-07-28 21:53     ` sam kleinman
2009-07-29 22:16       ` Eric H. Neilsen, Jr.
2009-07-31 17:01       ` Eric Schulte [this message]
2009-07-31 20:30         ` sam kleinman
2009-07-30  0:42 ` Eric Schulte
2009-08-02  1:46   ` Eric Schulte
2009-08-03  8:42     ` Sébastien Vauban
2009-08-03 15:38       ` Eric Schulte
2009-08-11  9:42         ` Sébastien Vauban
2009-08-11 18:55           ` Eric Schulte

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m2y6q4yefj.fsf@gmail.com \
    --to=schulte.eric@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=garen@tychoish.com \
    --cc=wxhgmqzgwmuf@spammotel.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).