How to get (and GIVE) career credit for software

How to get (and GIVE) career credit for software

Presented at Python in Astronomy 2018:


Arfon Smith

May 02, 2018


  1. How to get career credit for software Arfon Smith

  2. Software is important How Do Scientists Develop and Use Scientific

    Software?, Hannay et al, 2009
  3. Software is important becoming increasingly ^

  4. None
  5. None
  6. None
  7. deep intellectual contributions (Are) now encoded in software. Victoria Stodden

  8. the skills required to be a successful scientific researcher are

    increasingly indistinguishable from the skills required to be successful in industry. Jake VanderPlas
  9. We must find a way to legitimize software as a

    form of scholarship. Phil Bourne, Director for Data Science, NIH
  10. Until relatively recently, publishing software generally required (novel) scientific results

    Still true in many disciplines
  11. Many barriers to software being a first-class citizen

  12. Challenge Technical Cultural How do you cite software? ✔ ❌

    Software Citations aren’t allowed ❌ ✔ software isn’t citable ✔ ❌ Software citations aren’t indexed ✔ ✔ Software isn’t peer reviewed ❌ ✔ Software can’t cite other software ✔ ❌
  13. (ii) Many of our journals are society led/operated (i) ADS

    is a benevolent indexer
  14. Two things…

  15. Make something citable 1

  16. None
  17. Olsen, Jógvan Magnus Haugaard. PyFraME: Python tools for Fragment-based

    Multiscale Embedding. (2018). doi:10.5281/ zenodo.1168860
  18. None
  19. None
  20. None
  21. None
  22. * Full disclosure: I’m EIC of JOSS

  23. None
  24. Make it easy to be cited 2

  25. None
  26. None
  27. None
  28. None
  29. None
  30. 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 = {}, }
  31. 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} }
  32. None
  33. AAS Journals welcome papers which describe the design and function

    of software of relevance to research in astronomy and astrophysics. Such papers should contain a description of the software, its novel features and its intended use. Such papers need not include research results produced using the software, although including examples of applications can be helpful. There is no minimum length requirement for software papers. ” “
  34. Tell me exactly what to do: Publish your code (and

    put a license on it) Make your code ‘citable’ by archiving in Zenodo or figshare Encourage people to cite you Write a short paper in e.g. RNAAS or JOSS Write a full paper for ApJ (or other venue)
  35. [WIP]: How to GIVE career credit for software Arfon Smith

  36. When do you have power and influence as an academic?

  37. (i) In your research group/team (ii) As a reviewer (peer

    review, grant review panels) (iii) As a member of a search committee (iv) On a tenure review committee (v) When influencing policy (group, department, professional society, funding agency)
  38. Thanks