Skip to content

Instantly share code, notes, and snippets.

@jkitchin
Created August 25, 2016 15:52
Show Gist options
  • Save jkitchin/a73290045ff09bf5c0511e8dd102ae4e to your computer and use it in GitHub Desktop.
Save jkitchin/a73290045ff09bf5c0511e8dd102ae4e to your computer and use it in GitHub Desktop.
@article{kitchin-2016-autom-data,
abstract = "In the current scientific publishing landscape, there is a
need for an authoring workflow that easily integrates data and
code into manuscripts and that enables the data and code to be
published in reusable form. Automated embedding of data and
code into published output will enable superior communication
and data archiving. In this work, we demonstrate a proof of
concept for a workflow, org-mode, which successfully provides
this authoring capability and workflow integration. We
illustrate this concept in a series of examples for potential
uses of this workflow. First, we use data on citation counts
to compute the h-index of an author, and show two code
examples for calculating the h-index. The source for each
example is automatically embedded in the PDF during the export
of the document. We demonstrate how data can be embedded in
image files, which themselves are embedded in the document.
Finally, metadata about the embedded files can be
automatically included in the exported PDF, and accessed by
computer programs. In our customized export, we embedded
metadata about the attached files in the PDF in an Info field.
A computer program could parse this output to get a list of
embedded files and carry out analyses on them. Authoring tools
such as Emacs + org-mode can greatly facilitate the
integration of data and code into technical writing. These
tools can also automate the embedding of data into document
formats intended for consumption.",
author = "Kitchin, John R. and Van Gulick, Ana E. and Zilinski, Lisa D.",
keywords = {orgmode},
doi = "10.1007/s00799-016-0173-7",
issn = "1432-1300",
journal = "International Journal on Digital Libraries",
pages = "1--6",
title = {Automating Data Sharing Through Authoring Tools},
url = "http://dx.doi.org/10.1007/s00799-016-0173-7",
year = 2016,
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment