Citing Jupyter

[asmeurer]

What is the preferred citation to use for citing Jupyter in an academic paper?

We have used this citation for our sympy paper, but one of the reviewers has asked for a more up-to-date citation, since that citation is about IPython, not Jupyter.

[takluyver]

We're working on a proper citable reference paper for Jupyter, but that's taking some time - if you need something now, I think this paper in the proceedings of this year's ElPub conference is the most general citation we've got at the moment: http://ebooks.iospress.nl/publication/42900

[go-bears]

Does this help? It looks likes there's third-party integration that provides a digital object identifier (DOI)

[kif]

Can I suggest you to define "Zenodo" as hook in your GitHub project? Each release, tagged as such in github will automatically get a DOI to be cited.
(I need a DOI for jupyter as well)

[thomasfedb]

I would also like to cite Jupyter in a paper, is there a preferred citation yet? Should we simply cite the project website?

[takluyver]

We're working on a proper citable reference paper. In the meantime, feel free to cite the website, or you can cite this conference paper.

[thomasfedb]

Thanks @takluyver. Also, does Project Jupiter have an official location? Are you a registered entity anywhere?

[takluyver]

Numfocus is the legal entity behind the project - it's a US nonprofit, with a registered address in Texas.

[kif]

On Sun, 26 Nov 2017 18:18:16 +0000 (UTC) Thomas Kluyver ***@***.***> wrote: [Numfocus](https://www.numfocus.org/#) is the legal entity behind the project - it's a US nonprofit, with a registered address in Texas.

Could you declare a project on Zenodo, it provides you with a DOI. Then every (signed) release gets a DOI automatically and it is for free :)

[amcdawes]

If it's helpful to anyone, I've made the following bibtex entry for the conference paper mentioned above.

@conference{Kluyver:2016aa,
	Author = {Thomas Kluyver and Benjamin Ragan-Kelley and Fernando P{\'e}rez and Brian Granger and Matthias Bussonnier and Jonathan Frederic and Kyle Kelley and Jessica Hamrick and Jason Grout and Sylvain Corlay and Paul Ivanov and Dami{\'a}n Avila and Safia Abdalla and Carol Willing},
	Booktitle = {Positioning and Power in Academic Publishing: Players, Agents and Agendas},
	Editor = {F. Loizides and B. Schmidt},
	Organization = {IOS Press},
	Pages = {87 - 90},
	Title = {Jupyter Notebooks -- a publishing format for reproducible computational workflows},
	Year = {2016}}

[takluyver]

Thanks @amcdawes ! We're still aiming to get another paper published that will be a better citable reference.

[gregcaporaso]

@takluyver, is that conference paper still the best citation? Just want to make sure that I'm citing Jupyter correctly. Thanks!

[takluyver]

Plenty of people have talked about Jupyter at conferences since that one, but I don't know of one with an equally broad title. I don't keep up with this stuff very much, though, so it might be worth checking with people like Fernando, Brian, Min and Matthias who may know of better ones.

[inutano]

Hi, I found the ELPUB record of the conference paper here and says the DOI is: 10.3233/978-1-61499-649-1-87.
Is this still the latest citable (open) material?

[takluyver]

I don't know of anything more recent with a similarly broad title, but if anyone is aware of one, please post it in this thread.

I feel a bit bad that a conference paper on which I'm first author seems to now be the de-facto standard citation for Jupyter, which is not largely my work, just because I was the one presenting at that conference. But the efforts to publish a dedicated paper for this stalled, and I don't have the time or the energy to push them to a conclusion.

[jameshowison]

Could you put a CITATION file in the top level of your repo? I'd love CiteAs.org to pick this up. Other options for making discoverable requests for citation.

http://citeas.org/modify-your-citation

[lzkelley]

If it's helpful to anyone, I've made the following bibtex entry for the conference paper mentioned above.

@conference{Kluyver:2016aa,
	Author = {Thomas Kluyver and Benjamin Ragan-Kelley and Fernando P{\'e}rez and Brian Granger and Matthias Bussonnier and Jonathan Frederic and Kyle Kelley and Jessica Hamrick and Jason Grout and Sylvain Corlay and Paul Ivanov and Dami{\'a}n Avila and Safia Abdalla and Carol Willing},
	Booktitle = {Positioning and Power in Academic Publishing: Players, Agents and Agendas},
	Editor = {F. Loizides and B. Schmidt},
	Organization = {IOS Press},
	Pages = {87 - 90},
	Title = {Jupyter Notebooks -- a publishing format for reproducible computational workflows},
	Year = {2016}}

I think this is a little more expansive (my journal complained about missing fields):

@inproceedings{jupyter,
       booktitle = {Positioning and Power in Academic Publishing: Players, Agents and Agendas},
          editor = {Fernando Loizides and Birgit Scmidt},
           title = {Jupyter Notebooks - a publishing format for reproducible computational workflows},
          author = {Thomas Kluyver and Benjamin Ragan-Kelley and Fernando P{\'e}rez and Brian Granger and Matthias Bussonnier and Jonathan Frederic and Kyle Kelley and Jessica Hamrick and Jason Grout and Sylvain Corlay and Paul Ivanov and Dami{\'a}n Avila and Safia Abdalla and Carol Willing and  Jupyter development team},
       publisher = {IOS Press},
         address = {Netherlands},
            year = {2016},
           pages = {87--90},
             url = {https://eprints.soton.ac.uk/403913/},
        abstract = {It is increasingly necessary for researchers in all fields to write computer code, and in order to reproduce research results, it is important that this code is published. We present Jupyter notebooks, a document format for publishing code, results and explanations in a form that is both readable and executable. We discuss various tools and use cases for notebook documents.}
}

Added to PR: #536

[SamTov]

For those who do not wish to create their own bibtex file you can download the citation in several formats from here:

https://eprints.soton.ac.uk/403913/

[timothygebhard]

Is this still the best thing to cite if one wants to acknowledge Jupyter? Just asking, because it seems like the DOI cannot be resolved by CrossRef, and NASA/ADS (the paper search engine for astrophysics) does not seem to have it in its index?

I noticed that there also is this new paper, would that perhaps be considered an acceptable alternative? 🙂

[fangohr]

There is also this nice and recent paper by Fernando and Brian: https://ieeexplore.ieee.org/document/9387490 (preprint at https://www.authorea.com/doi/full/10.22541/au.161298309.98344404/v2).

(A summary of papers about Jupyter or its usage in computational science is available at a personal page at https://fangohr.github.io/blog/jupyter-for-computational-science-and-data-science.html#references . Disclaimer: I created that page last year.)