diff --git a/README.md b/README.md index 0e4f8ad..ebce6dc 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,7 @@ This is an exemplar project designed to showcase best practices in developing sc Rather this project is primarily designed to showcase the tools and practices available to you when developing scientific software projects. Maybe you are a PhD student just starting, or a researcher just about to embark on a larger scale software project - there should be something interesting here for you. ## Table of contents + 1. [Introduction](docs/learning/01%20Introduction.ipynb) 1. [Packaging It Up](docs/learning/02%20Packaging%20It%20Up.ipynb) 1. [Writing a Markov Chain Monte Carlo Sampler](docs/learning/03%20Writing%20a%20Markov%20Chain%20Monte%20Carlo%20Sampler.ipynb) @@ -38,7 +39,9 @@ Rather this project is primarily designed to showcase the tools and practices av Take a look at a the table of contents below and see if there are any topics that might be useful to you. The actual code lives in `./code` and the documentation in `./docs/learning` When you're ready to dive in you have three options: + ### 1. Launch them in Binder (easiest but a bit slow) + [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/ImperialCollegeLondon/ReCoDE_MCMCFF/HEAD?urlpath=lab%2Ftree%2Fdocs%2Flearning%2F01%20Introduction.ipynb) ### 2. Clone the repo and run the jupyter notebooks locally. (Faster but requires you have python/jupyter installed) @@ -52,8 +55,8 @@ jupyter lab ### 3. View them non-interactively in GitHub via the links in the table of contents - ## The map + ```bash . ├── CITATION.cff # This file describes how to cite the work contained in this repository. @@ -75,12 +78,11 @@ jupyter lab ``` ## External Resources + - [The Turing Way](https://the-turing-way.netlify.app/) has tons of great resources on the topics discussed here. - [Intermediate Research Software Development in Python](https://carpentries-incubator.github.io/python-intermediate-development/index.html) - - -[TDD]: learning/01%20Introduction.ipynb +[tdd]: learning/01%20Introduction.ipynb [intro]: learning/01%20Introduction.ipynb [packaging]: learning/02%20Packaging%20it%20up.ipynb [testing]: learning/02%20Testing.ipynb diff --git a/setup.cfg b/setup.cfg index ecfe54e..b9cdbf7 100644 --- a/setup.cfg +++ b/setup.cfg @@ -18,21 +18,24 @@ package_dir = packages = find: python_requires = >=3.6 install_requires = - numpy == 1.21 - scipy == 1.7 - matplotlib == 3.5 - numba == 0.55 - ipykernel == 6.9 # Allows this conda environment to show up automatically in Jupyter Lab - watermark == 2.3 # Generates a summary of package version for use inside Jupyter Notebooks + numpy == 1.21 + scipy == 1.7 + matplotlib == 3.5 + numba == 0.55 + ipykernel == 6.9 # Allows this conda environment to show up automatically in Jupyter Lab + watermark == 2.3 # Generates a summary of package version for use inside Jupyter Notebooks + +[options.extras_require] +dev = + pytest == 7.1 # Testing + pytest-cov == 3.0 # For Coverage testing + hypothesis == 6.29 # Property based testing + pre-commit == 2.20 + jupyterlab == 3.4.3 +docs = + ipykernel == 6.9.0 + sphinx == 5.0.0 + myst-nb == 0.16.0 [options.packages.find] where = src -dev = - pytest == 7.1 # Testing - pytest-cov == 3.0 # For Coverage testing - hypothesis == 6.29 # Property based testing - pre-commit == 2.20 - -docs = - sphinx == 5.0 # For building the documentation - myst-nb == 0.16