Python for Astronomy Tutorial
Instructor: Brett Morris
Thursday, October 10, 2019
Harrison 170
University of Exeter
Rough Schedule
| Lesson | Time |
|---|---|
| Intro to HDF5 | 9:30-10:00 |
| Packaging tutorial | 10:00-12:30 |
Setup
If you’re a conda user, simply type:
conda install numpy scipy astropy matplotlib h5py
conda install -c conda-forge jupyterlab
If you prefer pip, type:
pip install numpy scipy astropy matplotlib h5py jupyterlab
Further reading
For additional resources on getting up to speed in Python, I highly recommend Jake Van der Plas’ book A Whirlwind Tour of Python, which is currently available for free. If you’re ready to go deeper, there are many freely available books on Python to try.
Python Packaging Tutorial
Example repo: leonard
Packaging references
- astropy package-template tutorial
- Simplified project structure reference
- Python 3 official packaging reference
- reStructuredText cheat sheet for Sphinx documentation
- Reference on 2->3 compatibility
astropy-related FAQ
- What’s an astropy-affiliated package?
- How can I make my code style look more legit? See: astropy’s Coding Guidelines
- How does the testing machinery work? See: astropy’s Testing Guidelines
- How do I make the best use of git for my project? See: astropy’s Workflow for Maintainers
- How do I make the most of my documentation? See: astropy’s Writing Documentation
Next steps
- Make your code citable by minting a Zenodo DOI for your GitHub repository
- Consider submitting your software to the Journal of Open Source Software (example 1, example 2)
- Make your code conda-installable with a few relatively simple steps with conda-forge