Re: Open Peer-Review Reproducible Publication with Org and GRASS

[Daniele Pizzolli <dan@toel.it>]

On Fri, Jun 03 2016, Ken Mankoff wrote:

> Hi Org and GRASS lists,
>
> I just wanted to let these two lists know that I've just posted a
> paper written in Org and using GRASS (text-mode) and Python for the
> analysis. My goal was to create not just an open access publication,
> but a fully reproducible publication. This is an early announcement,
> and the paper may not pass peer review.

Hello Ken,

Thanks for sharing, I had only a brief look.  In the meantime some
early thoughts while it downloads the data.

[]

> To make it easier to reproduce... including my emacs.org seems
> overkill. Including a Virtual Machine that contains everything,
> including my ~/.emacs.d/ and all the software and data seems like the
> right thing to do, but journals don't want to host a 20 GB VM with the
> publication.

Well, you need only the recipe to build the VM.  Fortunately there are
a lot of tools that help to do this.  Unfortunately there are too
many, and not all of them focus on the reproducible side...

In the meantime I saw few main problems in your current document:

- No "One build step"
- Hardcoded path, for example
  root = "/Users/mankoff/Documents/Papers/B/Brinkerhoff/"
- I did not found the Grass installation part, I guess I will have an
  error later...
- Missing latex toolchain installation

Are you interested in fixing those issues?  If yes please share your
progress or ideas.

Best,
Daniele