mirror of
https://github.com/ImperialCollegeLondon/ReCoDE_MCMCFF.git
synced 2025-06-26 08:51:16 +02:00
82 lines
3.4 KiB
Markdown
82 lines
3.4 KiB
Markdown
<h1 align="center">🎲 ⛓️ 👉 🧪 Markov Chain Monte Carlo for fun and profit</h1>
|
||
<p align="center">
|
||
<em>Using random numbers to do all the things.</em>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<img src="https://github.com/Imperial-CMTH/koala/actions/workflows/ci.yml/badge.svg"/>
|
||
<a href="https://zenodo.org/badge/latestdoi/422218038">
|
||
<img src="https://zenodo.org/badge/422218038.svg"/>
|
||
</a>
|
||
<a href="https://wfxr.mit-license.org/2017">
|
||
<img src="https://img.shields.io/badge/License-MIT-brightgreen.svg"/>
|
||
</a>
|
||
<a href="https://mybinder.org/v2/gh/TomHodson/ReCoDE_MCMCFF/HEAD">
|
||
<img src="https://mybinder.org/badge_logo.svg"/>
|
||
</a>
|
||
</p>
|
||
|
||
This is an exemplar project designed to showcase best practices in developing scientific software as part of the ReCoDE Project at Imperial College London.
|
||
|
||
**You do not need to know or care about Markov Chain Monte Carlo for this to be useful to you.**
|
||
|
||
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. [A short introduction][intro]
|
||
1. [Organising code and python packaging][packaging]
|
||
1. [Testing your code][testing]
|
||
1. Planning the project, MVPs, Premature Optimisation,
|
||
1. Planning out a larger software project
|
||
1. Using Jupyter Notebooks during development
|
||
1. Documentation
|
||
1. Reproducibility of software outputs
|
||
1. Citing software in a publication: CITATION.cff
|
||
1. Managing an open source project, issues, milestones
|
||
|
||
## How to use this repository
|
||
|
||
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 `./learning`
|
||
|
||
When you're ready to dive in you have three options:
|
||
### 1. Launch them in Binder (easiest but a bit slow)
|
||
[](https://mybinder.org/v2/gh/TomHodson/ReCoDE_MCMCFF/HEAD?labpath=learning%2F01%20Introduction.ipynb)
|
||
|
||
### 2. Clone the repo and run the jupyter notebooks locally. (Faster but requires you have python/jupyter installed)
|
||
|
||
```
|
||
git clone
|
||
cd
|
||
pip install -r requirements.txt
|
||
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.
|
||
├── LICENSE # Outlines what legal rights you have to use this software.
|
||
├── README.md # You are here!
|
||
├── README.md # Human readable information about the little python package in here
|
||
├── pyproject.toml # Machine readable information about that same package
|
||
├── setup.cfg # Tells Pip how to install this package
|
||
├── src
|
||
| └── MCFF # The actual code lives in here!
|
||
└─ tests # automated tests for the code
|
||
└── learning # Supporting documentation
|
||
```
|
||
|
||
## 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
|
||
[intro]: learning/01%20Introduction.ipynb
|
||
[packaging]: learning/02%20Packaging%20it%20up.ipynb
|
||
[testing]: learning/02%20Testing.ipynb
|