[AstroPy] Best practices for Python sample code in journal articles

Stuart Mumford stuart at cadair.com
Thu Apr 28 11:42:45 EDT 2016


Hi Jo,

FWIW, I had this minted + Arxiv issue when I submitted the SunPy paper,
what I did in the end was swap to the much more boring looking
`listings` package for ArXiV and use minted for everything else.

https://github.com/sunpy/sunpy-0.4-paper/commit/d91dd8809f469e7a4295c317feeded41aeca17c8

Stuart

On 28/04/16 15:12, Jo Bovy wrote:
> Hi Leo,
>
> I'm not sure this is exactly what you're looking for, but in my paper
> <http://adsabs.harvard.edu/abs/2015ApJS..216...29B> on galpy, I used
> minted <https://github.com/gpoore/minted> to typeset Python code as
> figures (and some inline). The only downside is that arXiv doesn't
> allow this, because you need to run latex with -shell-escape (I got my
> paper on arXiv in a very hacky way). ApJS didn't have any problems
> with getting this in print.
>
> Best,
>
> Jo
>
> On Thu, Apr 28, 2016 at 10:00 AM, Singer, Leo P.
> (GSFC-661.0)[UNIVERSITIES SPACE RESEARCH ASSOCIATION]
> <leo.p.singer at nasa.gov <mailto:leo.p.singer at nasa.gov>> wrote:
>
>     Hi,
>
>     I am working on an ApJ submission that I would like to pair with a
>     supplement paper that contains (among other things) some
>     Astropy-based sample/tutorial Python code to acquaint the reader
>     with an accompanying data release. Are there any established best
>     practices for including Python in journal articles? Should code
>     and output be presented docstring-style or should it look like an
>     IPython session? Does anyone have nice examples of astronomy
>     papers that include supplemental IPython notebooks?
>
>     If anyone is interested, this is the article and data release:
>     https://arxiv.org/abs/1603.07333
>     http://asd.gsfc.nasa.gov/Leo.Singer/going-the-distance/
>
>     Cheers,
>     Leo
>
>
>     Dr. Leo P. Singer
>     NASA Postdoctoral Program Fellow
>     Goddard Space Flight Center
>     8800 Greenbelt Rd., B34, Room S239
>     Greenbelt, MD 20771
>     _______________________________________________
>     AstroPy mailing list
>     AstroPy at scipy.org <mailto:AstroPy at scipy.org>
>     https://mail.scipy.org/mailman/listinfo/astropy
>
>
>
>
> _______________________________________________
> AstroPy mailing list
> AstroPy at scipy.org
> https://mail.scipy.org/mailman/listinfo/astropy

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/astropy/attachments/20160428/db3b59ed/attachment.html>


More information about the AstroPy mailing list