1 min read

Hands-on Introduction to Literate Programming

  • Tim Dennis, Harrison Dekker, and Juliane Schneider
  • Fri, 27 Oct, 10:00–12:00, Room 4
  • Force11 2017

A fundamental challenge for open science is how best to create and share documents containing computational results. Traditional methods involve maintaining the code, generated tables and figures, and text as separate files and manually assembling them into a finished document. As projects grow in complexity, this approach can lead to procedures which are error prone and hard to replicate. Fortunately, new tools are emerging to address this problem. The workshop will introduce a solution that’s gaining popularity in the R community utilizing the freely available RStudio development environment and other open source components. In the workshop we’ll demonstrate how to create a “compilable” document containing all the text elements (including bibliography), as well as the code required to create embedded graphs and tables.

We’ll demonstrate how the process facilitates making revisions when, for example, a reviewer has suggested a revision or when there has been a change in the underlying data. We’ll also demonstrate the convenience of integrating version control into the workflow using RStudio’s built-in support for git. http://meetingorganizer.copernicus.org/FORCE2017/FORCE2017-99.pdf