/case-studies

exoplanet | case studies

Primary LanguageShellMIT LicenseMIT

exoplanet | case studies

This is where the case studies for exoplanet live!

Contributing a case study

First: thank you for considering contributing a case study!

Take a look at the exoplanet developer docs for information about how to set up your system. Then, you can fork this repo and add your case study as a notebook to the docs/notebooks directory.

A few things to double check:

  1. The format should follow one of the existing case studies. In particular, the first two cells should be %matplotlib inline and %run notebook_setup, followed by a markdown cell describing the case study.
  2. Make sure that you clear the outputs of your notebook before committing. Otherwise this repo will get unruly! I normally use nbstripout to make sure that this always happens.

Finally, please edit the docs/conf.py file to include the info about your case study in the case_studies variable. If it's not clear what to do there, we can discuss it in the pull request thread.

Updating the notebooks

To update the notebooks you'll want a big machine (I'll do this at work for an actual release - you don't need to do this if you're contributing!). You'll need a file .github_api_key with (surprise!) your GitHub API key as the only contents. Then you can run ./run_notebooks.sh to automatically execute the notebooks and push them to the auto_notebooks branch.