Upgrade to Pro — share decks privately, control downloads, hide ads and more …

The Journal of Open Source Software

The Journal of Open Source Software

Slides from the URSSI (http://urssi.us) workshop at UC Berkeley

Arfon Smith

April 11, 2018
Tweet

More Decks by Arfon Smith

Other Decks in Research

Transcript

  1. The Journal of Open Source Software
    Arfon M. Smith, Kyle E. Niemeyer, Daniel S. Katz, Lorena A. Barba, George
    Githinji, Melissa Gymrek, Kathryn D. Huff, Christopher R. Madan, Abigail Cabunoc
    Mayes, Kevin M. Moerman, Pjotr Prins, Karthik Ram, Ariel Rokem, Tracy K. Teal,
    Roman Valls Guimera, and Jacob T. Vanderplas
    https://joss.theoj.org
    Creative Commons Attribution 4.0 International License.

    View full-size slide

  2. A developer friendly journal for research
    software packages
    > A formal peer review process that is designed to improve the
    quality of the software submitted.
    > If your software is already well documented then paper
    preparation should take no more than an hour.

    View full-size slide

  3. https://peerj.com/articles/cs-147/

    View full-size slide

  4. How to get career credit for
    research software in two easy steps…

    View full-size slide

  5. Make something citable
    1

    View full-size slide

  6. Make it easy to be cited
    2

    View full-size slide

  7. “Make something citable”
    > Upload your code to GitHub (or other public repository)
    > Create a DOI for repository via Zenodo/figshare etc.
    > Write a paper about your software
    JOSS lowers
    the cost of this

    View full-size slide

  8. “Make it easy to be cited”

    View full-size slide

  9. R
    > citation(‘ggplot2')
    To cite ggplot2 in publications, please use:
    H. Wickham. ggplot2: elegant graphics for data analysis.
    Springer New York, 2009.
    A BibTeX entry for LaTeX users is
    @Book{,
    author = {Hadley Wickham},
    title = {ggplot2: elegant graphics for data analysis},
    publisher = {Springer New York},
    year = {2009},
    isbn = {978-0-387-98140-6},
    url = {http://had.co.nz/ggplot2/book},
    }

    View full-size slide

  10. Python
    > import astroML as aml
    > aml.__citation__
    @INPROCEEDINGS{astroML,
    author={{Vanderplas}, J.T. and {Connolly}, A.J.and {Ivezi{\'c}},
    {\v Z}. and {Gray}, A.},
    booktitle={Conference on Intelligent Data Understanding (CIDU)},
    title={Introduction to astroML: Machine learning for astrophysics},
    month={Oct.},
    pages={47 -54},
    doi={10.1109/CIDU.2012.6382200},
    year={2012}
    }

    View full-size slide

  11. “How URSSI could help”
    > Develop/document best practices for receiving career credit
    for software
    > Develop/document best practices for awarding career credit
    for software
    > Strive to make JOSS unnecessary? (better fixes than just
    software papers)

    View full-size slide