<div dir="ltr"><div class="markdown-here-wrapper" style=""><h2 id="re-why-cite-python-" style="margin:1.3em 0px 1em;padding:0px;font-weight:bold;font-size:1.4em;border-bottom:1px solid rgb(204,204,204)">RE: Why cite Python….</h2>
<p style="margin:1.2em 0px!important">I would say that in this paper — <a href="http://conference.scipy.org/proceedings/scipy2015/pdfs/jacqueline_kazil.pdf">http://conference.scipy.org/proceedings/scipy2015/pdfs/jacqueline_kazil.pdf</a>, where we introduced a new library, we should have cited Python, because the library was based in Python. We were riding on the coattails of Python and if Python did not exist, then this library would not exist. </p>
<p style="margin:1.2em 0px!important">(taking this a level higher)<br>Just as someone doing research (a specific application) should cite the Mesa library. Without the good and bad that is Mesa, their research would have taken a different form. </p>
<p style="margin:1.2em 0px!important">Since my Ph.D is on Mesa, I will be citing Python there. </p>
<p style="margin:1.2em 0px!important">I think for more insight we can look at who has cited some of Guido’s stuff…<br>For example: <a href="https://scholar.google.com/scholar?cites=900267235435084077&as_sdt=20005&sciodt=0,9&hl=en">https://scholar.google.com/scholar?cites=900267235435084077&as_sdt=20005&sciodt=0,9&hl=en</a></p>
<p style="margin:1.2em 0px!important">Does that help?</p>
<h2 id="re-just-like-r-versions" style="margin:1.3em 0px 1em;padding:0px;font-weight:bold;font-size:1.4em;border-bottom:1px solid rgb(204,204,204)">RE: Just like R - Versions</h2>
<p style="margin:1.2em 0px!important">@Stephen<br>Are you suggesting major versions or minor versions? </p>
<h2 id="re-guido-s-prio-works" style="margin:1.3em 0px 1em;padding:0px;font-weight:bold;font-size:1.4em;border-bottom:1px solid rgb(204,204,204)">RE: Guido’s prio works</h2>
<p style="margin:1.2em 0px!important">Some of those have weight already. Should we be picking one those and pointing people to that? </p>
<h2 id="final-decision" style="margin:1.3em 0px 1em;padding:0px;font-weight:bold;font-size:1.4em;border-bottom:1px solid rgb(204,204,204)">Final decision</h2>
<p style="margin:1.2em 0px!important">I am going to the NumFocus summit for maintainers of Science Python libraries next week. I believe that the Science Python community is where the main audience for this is… correct me if you think this is a wrong assumption. </p>
<p style="margin:1.2em 0px!important">I thought I could take two to three concrete formats and user test there and report on how community members who would be using the citation feel. </p>
<p style="margin:1.2em 0px!important">Good idea? Bad idea? </p>
<div title="MDH:PGRpdiBkaXI9Imx0ciI+PGRpdiBkaXI9Imx0ciI+IyMgUkU6IFdoeSBjaXRlIFB5dGhvbi4uLi4m
bmJzcDs8ZGl2Pjxicj48L2Rpdj48ZGl2Pkkgd291bGQgc2F5IHRoYXQgaW4gdGhpcyBwYXBlciAt
LSZuYnNwOzxhIGhyZWY9Imh0dHA6Ly9jb25mZXJlbmNlLnNjaXB5Lm9yZy9wcm9jZWVkaW5ncy9z
Y2lweTIwMTUvcGRmcy9qYWNxdWVsaW5lX2themlsLnBkZiIgdGFyZ2V0PSJfYmxhbmsiIGRhdGEt
c2FmZXJlZGlyZWN0dXJsPSJodHRwczovL3d3dy5nb29nbGUuY29tL3VybD9xPWh0dHA6Ly9jb25m
ZXJlbmNlLnNjaXB5Lm9yZy9wcm9jZWVkaW5ncy9zY2lweTIwMTUvcGRmcy9qYWNxdWVsaW5lX2th
emlsLnBkZiZhbXA7c291cmNlPWdtYWlsJmFtcDt1c3Q9MTUzNzIyMjk1OTk2NjAwMCZhbXA7dXNn
PUFGUWpDTkV4eG9lYm45cFhKejd2Wktqa2hqNl9mX1lYcVEiPmh0dHA6Ly9jb25mZXJlbmNlLnNj
aXB5Ljx3YnI+b3JnL3Byb2NlZWRpbmdzL3NjaXB5MjAxNS88d2JyPnBkZnMvamFjcXVlbGluZV9r
YXppbC5wZGY8L2E+LCB3aGVyZSB3ZSBpbnRyb2R1Y2VkIGEgbmV3IGxpYnJhcnksIHdlIHNob3Vs
ZCBoYXZlIGNpdGVkIFB5dGhvbiwgYmVjYXVzZSB0aGUgbGlicmFyeSB3YXMgYmFzZWQgaW4gUHl0
aG9uLiBXZSB3ZXJlIHJpZGluZyBvbiB0aGUgY29hdHRhaWxzIG9mIFB5dGhvbiBhbmQgaWYgUHl0
aG9uIGRpZCBub3QgZXhpc3QsIHRoZW4gdGhpcyBsaWJyYXJ5IHdvdWxkIG5vdCBleGlzdC4mbmJz
cDs8L2Rpdj48ZGl2Pjxicj48L2Rpdj48ZGl2Pih0YWtpbmcgdGhpcyBhIGxldmVsIGhpZ2hlcik8
L2Rpdj48ZGl2Pkp1c3QgYXMgc29tZW9uZSBkb2luZyByZXNlYXJjaCAoYSBzcGVjaWZpYyBhcHBs
aWNhdGlvbikgc2hvdWxkIGNpdGUgdGhlIE1lc2EgbGlicmFyeS4gV2l0aG91dCB0aGUgZ29vZCBh
bmQgYmFkIHRoYXQgaXMgTWVzYSwgdGhlaXIgcmVzZWFyY2ggd291bGQgaGF2ZSB0YWtlbiBhIGRp
ZmZlcmVudCBmb3JtLiZuYnNwOzwvZGl2PjxkaXY+PGJyPjwvZGl2PjxkaXY+U2luY2UgbXkgUGgu
RCBpcyBvbiBNZXNhLCBJIHdpbGwgYmUgY2l0aW5nIFB5dGhvbiB0aGVyZS4mbmJzcDs8L2Rpdj48
ZGl2Pjxicj48L2Rpdj48ZGl2PkkgdGhpbmsgZm9yIG1vcmUgaW5zaWdodCB3ZSBjYW4gbG9vayBh
dCB3aG8gaGFzIGNpdGVkIHNvbWUgb2YgR3VpZG8ncyBzdHVmZi4uLiZuYnNwOzwvZGl2PjxkaXY+
Rm9yIGV4YW1wbGU6IDxhIGhyZWY9Imh0dHBzOi8vc2Nob2xhci5nb29nbGUuY29tL3NjaG9sYXI/
Y2l0ZXM9OTAwMjY3MjM1NDM1MDg0MDc3JmFtcDthc19zZHQ9MjAwMDUmYW1wO3NjaW9kdD0wLDkm
YW1wO2hsPWVuIiB0YXJnZXQ9Il9ibGFuayIgZGF0YS1zYWZlcmVkaXJlY3R1cmw9Imh0dHBzOi8v
d3d3Lmdvb2dsZS5jb20vdXJsP3E9aHR0cHM6Ly9zY2hvbGFyLmdvb2dsZS5jb20vc2Nob2xhcj9j
aXRlcyUzRDkwMDI2NzIzNTQzNTA4NDA3NyUyNmFzX3NkdCUzRDIwMDA1JTI2c2Npb2R0JTNEMCw5
JTI2aGwlM0RlbiZhbXA7c291cmNlPWdtYWlsJmFtcDt1c3Q9MTUzNzIyMjk1OTk2NjAwMCZhbXA7
dXNnPUFGUWpDTkdhZlpFczcxMG9BWTlQb0FfSEZnZFhydDhxMVEiPmh0dHBzOi8vc2Nob2xhci5n
b29nbGUuY29tLzx3YnI+c2Nob2xhcj9jaXRlcz08d2JyPjkwMDI2NzIzNTQzNTA4NDA3NyZhbXA7
YXNfc2R0PTx3YnI+MjAwMDUmYW1wO3NjaW9kdD0wLDkmYW1wO2hsPWVuPC9hPjxicj48L2Rpdj48
ZGl2Pjxicj48L2Rpdj48ZGl2PkRvZXMgdGhhdCBoZWxwPzwvZGl2PjxkaXY+PGJyPjwvZGl2Pjxk
aXY+IyMgUkU6IEp1c3QgbGlrZSBSIC0gVmVyc2lvbnM8YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+
PGRpdj5AU3RlcGhlbiZuYnNwOzxicj48L2Rpdj48ZGl2PkFyZSB5b3Ugc3VnZ2VzdGluZyBtYWpv
ciB2ZXJzaW9ucyBvciBtaW5vciB2ZXJzaW9ucz8mbmJzcDs8L2Rpdj48ZGl2Pjxicj48L2Rpdj48
ZGl2Pjxicj48L2Rpdj48ZGl2PiMjIFJFOiBHdWlkbydzIHByaW8gd29ya3MmbmJzcDs8YnI+PC9k
aXY+PGRpdj48YnI+PC9kaXY+PGRpdj5Tb21lIG9mIHRob3NlIGhhdmUgd2VpZ2h0IGFscmVhZHku
IFNob3VsZCB3ZSBiZSBwaWNraW5nIG9uZSB0aG9zZSBhbmQgcG9pbnRpbmcgcGVvcGxlIHRvIHRo
YXQ/Jm5ic3A7PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj4jIyBGaW5h
bCBkZWNpc2lvbiZuYnNwOzwvZGl2PjxkaXY+PGJyPjwvZGl2PjxkaXY+SSBhbSBnb2luZyB0byB0
aGUgTnVtRm9jdXMgc3VtbWl0IGZvciBtYWludGFpbmVycyBvZiBTY2llbmNlIFB5dGhvbiBsaWJy
YXJpZXMgbmV4dCB3ZWVrLiBJIGJlbGlldmUgdGhhdCB0aGUgU2NpZW5jZSBQeXRob24gY29tbXVu
aXR5IGlzIHdoZXJlIHRoZSBtYWluIGF1ZGllbmNlIGZvciB0aGlzIGlzLi4uIGNvcnJlY3QgbWUg
aWYgeW91IHRoaW5rIHRoaXMgaXMgYSB3cm9uZyBhc3N1bXB0aW9uLiZuYnNwOzwvZGl2PjxkaXY+
PGJyPjwvZGl2PjxkaXY+SSB0aG91Z2h0IEkgY291bGQgdGFrZSB0d28gdG8gdGhyZWUgY29uY3Jl
dGUgZm9ybWF0cyBhbmQgdXNlciB0ZXN0IHRoZXJlIGFuZCByZXBvcnQgb24gaG93IGNvbW11bml0
eSBtZW1iZXJzIHdobyB3b3VsZCBiZSB1c2luZyB0aGUgY2l0YXRpb24gZmVlbC4mbmJzcDs8YnI+
PGJyPkdvb2QgaWRlYT8gQmFkIGlkZWE/Jm5ic3A7PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj48
YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRpdj48YnI+PC9kaXY+PGRp
dj48YnI+PC9kaXY+PC9kaXY+PC9kaXY+" style="height:0;width:0;max-height:0;max-width:0;overflow:hidden;font-size:0em;padding:0;margin:0"></div></div></div><br><div class="gmail_quote"><div dir="ltr">On Sun, Sep 16, 2018 at 4:35 AM Stephen J. Turnbull <<a href="mailto:turnbull.stephen.fw@u.tsukuba.ac.jp" target="_blank">turnbull.stephen.fw@u.tsukuba.ac.jp</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Jacqueline Kazil writes:<br>
<br>
 > *As a user, I am writing an academic paper and I need to cite Python. *<br>
<br>
I don't understand the meaning of "need" and "Python".  To understand<br>
your code, one likely needs the Language Reference and surely the<br>
Library Reference, and probably documentation of the APIs and<br>
semantics of various third party code.<br>
<br>
To just give credit to the Python project for the suite of tools<br>
you've used, a citation like the R Project's should do (I think this<br>
has appeared more than once, I copy it from José María Mateos's<br>
parallel post):<br>
<br>
 > To cite R in publications use:<br>
<br>
 >   R Core Team (2018). R: A language and environment for statistical<br>
 >   computing. R Foundation for Statistical Computing, Vienna, Austria.<br>
 >   URL <a href="https://www.R-project.org/" rel="noreferrer" target="_blank">https://www.R-project.org/</a>.<br>
<br>
I guess for Python that would be something like<br>
<br>
"""<br>
Python Core Developers [2018].  Python: A general purpose language for<br>
computing, with batteries included.  Python Software Foundation,<br>
Beaverton, OR.  <a href="https://www.python.org/" rel="noreferrer" target="_blank">https://www.python.org/</a>.<br>
"""<br>
<br>
I like R's citation() builtin.<br>
<br>
One caveat: I get the impression that the R Project is far more<br>
centralized than Python is, that there are not huge independent<br>
projects like SciPy and NumPy and Twisted and so on, nor independent<br>
implementations of the core language like PyPy and Jython.  So I<br>
suspect that for most serious scientific computing you would need to<br>
cite one or more third-pary projects as well, and perhaps an<br>
implementation such as PyPy or Jython.<br>
<br>
Jacqueline again:<br>
<br>
 > Let's throw reproducibility out the window for now (<--- something<br>
 > I never thought I would say), because that should be captured in<br>
 > the code, not in the citations.<br>
 ><br>
 > So, if we don't need the specific version of Python, then maybe<br>
 > creating one citation is all we need.<br>
<br>
Do you realize that `3 / 2` means different computations depending on<br>
the version of Python?  And that `"a string"` produces different<br>
objects with different duck-types depending on the version?<br>
<br>
As far as handling versions, this would do, I think:<br>
<br>
f"""<br>
Python Core Developers [{release_year}].  Python: A general purpose<br>
language for computing, with batteries included, version<br>
{version_number}.  Python Software Foundation, Beaverton, OR.<br>
Project URL: <a href="https://www.python.org/" rel="noreferrer" target="_blank">https://www.python.org/</a>.<br>
"""<br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="m_6731870288200734281gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr">Jacqueline Kazil | @jackiekazil </div><div dir="ltr"><pre style="color:rgb(0,0,0)"><br></pre></div></div></div></div></div>