Alyssa Goodman edited Linking Code.md  over 9 years ago

Commit id: 341208586f7cd4605ee8d3d1ca70cfb8998f90fe

deletions | additions      

       

In the modern practice of astronomy a paper is often linked to a swath of computer code that outputs both the numerical conclusions of the paper (e. g. parameter estimates and errors) and the associated figures. Since reproducibility is a bedrock principle of the scientific method, we believe that easy access to underpinning code is crucial part of future publications.   ## Links to Software  By combining tools discussed elsewhere in this document, once can "mint" digital object identifiers that point to a particular version of software, assuming it is stored in an organized repostitory. One example is given here: https://guides.github.com/activities/citable-code/, on a web page that shows how to mint a citable DOI for code using the [GitHub](http://github.com) and [Zenodo] (http://zenodo.org) services together.  ## Executable Figures  iPython Notebooks are a nice modern example. These notebooks act as code that can be annotated and executed on the web, allowing an interested reader to study and even modify a copy of the underpinning code, without contacting the authors or initiating a long investigation. [iPython example from Hope's figure]  ## Links to Software  By combining tools discussed elsewhere in this document, once can "mint" digital object identifiers that point to a particular version of software, assuming it is stored in an organized repostitory. One example is given here: https://guides.github.com/activities/citable-code/, on a web page that shows how to mint a citable DOI for code using the [GitHub](http://github.com) and [Zenodo] (http://zenodo.org) services together.  xx AG clean up this info: The ASCL is indexed by the SAO/NASA Astrophysics Data System (ADS) and is citable by using the unique ascl ID assigned to each code. xx