Skip to content

This is a cookiecutter template to kickstart (scientific) research projects.

Notifications You must be signed in to change notification settings

SHEscher/research-project

Repository files navigation

Research-Project – a cookiecutter template for research projects

version License

This is a cookiecutter template for (scientific) research projects.

Usage

This template is used by scilaunch (a cookiecutter wrapper for scientific research projects):

# Install scilaunch
pip install -U scilaunch

# Create a new project in current folder
scilaunch

# alternatively link to parent folder
scilaunch path/to/parent/folder

The template can also be employed directly with cookiecutter using:

cookiecutter gh:SHEscher/research-project

However, ideally use this template with scilaunch to create your project, since there is some additional magic happening in the background.

And this is an excerpt of what you get:

🚀 yourgreatstudy/
├── 📄 README.md
├── 📂 code
│   ├── 📁 Rscripts
│   ├── 📁 configs
│   ├── 📂 notebooks
│   │   └── 🐍 yourgreatstudy.ipynb
│   ├── 📁 tests
│   └── 📂 yourgreatstudy
│       ├── 🐍 __init__.py
│       └── 📁 preprocessing
├── 📂 data
│   ├── 📋 participants.tsv
│   ├── 📁 sub-01
│   ├── 📁 sub-02
│   └── 📁 sub-03
├── 📂 literature
│   ├── 📁 pdfs
│   └── 📙 yourgreatstudy.bib
├── 📂 organisation
│   ├── 📁 ethics
│   ├── 📁 participation_forms
│   ├── 📁 preregistration
├── 📂 publications
│   ├── 📁 articles
│   ├── 📁 poster
│   └── 📁 presentations
├── 📄 pyproject.toml
├── 📂 results
│   └── 📁 datavisualization
└── 🐍 setup.py

TODO's

  • Option to add multiple authors
  • Option to add project keywords
  • Optional: Add examples for other data types than MRI, including simulation studies
  • ...

Credits

Thanks to audreyfeldroy for her inspiration with her cookiecutter-pypackage and the great cookiecutter package in general.