Brought to you by NumFOCUS Foundation and O’Reilly Media Inc.
The official Jupyter Conference
August 22-23, 2017: Training
August 23-25, 2017: Tutorials & Conference
New York, NY

Citing the Jupyter Notebook in the scientific publication process

Bernie Randles (UCLA), Hope Chen (Harvard University)
11:05am–11:45am Friday, August 25, 2017
Reproducible research and open science
Location: Murray Hill Level: Non-technical
Average rating: *****
(5.00, 1 rating)

Who is this presentation for?

  • Researchers and students

Prerequisite knowledge

  • Familiarity with the Jupyter Notebook

What you'll learn

  • Explore the open science framework and the various repositories and objects
  • Learn how the Jupyter Notebook is being used and cited in scientific research


Since the birth of the Jupyter Notebook several years ago, mentions of notebooks in research publications have increased. Although researchers have traditionally cited code and data related to their publications, they are increasingly using the Jupyter Notebook to share the processes involved in the act of scientific inquiry. Bernie Randles and Hope Chen explore various aspects of citing Jupyter notebooks as a complementary “recipe” to contextualize the data and code used in publications, discussing benefits, pitfalls, and best practices for creating the “paper of the future.”

Bernie and Hope share how researchers are currently mentioning notebooks and examine the traces created between the published paper, data, and code, which ordinarily live in different repositories. They then explain the FAIR (findable, accessible, interoperable, and reusable) principles of objects used in open science research and evaluate the Jupyter Notebook as a component of the FAIR ecosystem. Along the way, they outline past problems relating to linked code and data as well as new developments in the open source community that are addressing the issue of object permanence in a publicly accessible environment.

Bernie and Hope conclude by relating a case study of a paper submitted to an astronomy journal to showcase the various steps and decisions made in citing a Jupyter notebook. (One important aspect of the case study is that, because of collaborative work, some code can be made public, while other parts of the study must remain private, so decisions must be made to optimize these circumstances.) They then touch on improvements to how the Jupyter Notebook can be continued to be cited, its importance in the research process, and a potential primer for notebook citations that could be added to

Photo of Bernie Randles

Bernie Randles


Bernie Randles is a graduate student in the Information Studies program at UCLA. Her work is centered around knowledge creation in astronomy, specifically examining astronomers’ data and software pipeline practices. She also researches the use of open source software in scientific research organizations, primarily in data-rich and computationally intensive fields. Previously, Bernie worked in IT (wearing many hats, some red) at several colleges and universities. She holds degrees in math, computer science, and fine arts.

Photo of Hope Chen

Hope Chen

Harvard University

Born and raised in Taiwan, Hope Chen is a PhD candidate in astronomy and astrophysics at Harvard University. Since 2011, Hope has been a member of the Star Formation research group led by Alyssa A. Goodman of Harvard and has embarked on several research projects aimed at decoding the mysteries of structural formation in nearby cradles of stars, such as the Gould Belt molecular clouds. Hope is interested in making astronomy seamless and accessible and has been an ardent user of the Jupyter Notebook. Hope holds a degree from National Tsing Hua University with the highest distinction, the Dr. Mei Yi-Chih Prize.

Comments on this page are now closed.


Picture of Daniel Mietchen
05/10/2017 6:40am EDT

Hi – just saw this presentation, which nicely overlaps with mine on sharing Jupyter notebooks , of which citation is obviously an important element. I think it would also be good to bring up your case study in the context of the Force11 Software Citation Implementation Working Group already now, so that we can hope for some progress on these issues by the time of JupyterCon.