+ `;
+ })
+ .join("");
+
+ // click + keyboard
+ chart.querySelectorAll(".pub-year-row").forEach((row) => {
+ const go = () => {
+ const targetId = row.dataset.target;
+ const year = row.dataset.year;
+ const target = document.getElementById(targetId);
+ if (target) {
+ target.scrollIntoView({ behavior: "smooth", block: "start" });
+ setActiveYear(year);
+ // update URL hash (handig voor delen/back button)
+ history.replaceState(null, "", `#${targetId}`);
+ }
+ };
+
+ row.addEventListener("click", go);
+ row.addEventListener("keydown", (e) => {
+ if (e.key === "Enter" || e.key === " ") {
+ e.preventDefault();
+ go();
+ }
+ });
+ });
+ }
+
+ function getYearHeadings() {
+ // Pak h2/h3/h4 voor de zekerheid
+ const headings = Array.from(document.querySelectorAll("h2, h3, h4")).filter(isYearHeading);
+
+ // Zorg dat elk jaar een id heeft zodat we erheen kunnen scrollen
+ headings.forEach(ensureIdForYearHeading);
+
+ return headings;
+ }
+
+ function init() {
+ const chart = document.getElementById("pub-year-chart");
+ if (!chart) return;
+
+ const headings = getYearHeadings();
+ if (!headings.length) {
+ chart.innerHTML =
+ "
Publications per year
No year headings found.
";
+ return;
+ }
+
+ const data = headings.map((h, i) => {
+ const next = headings[i + 1] || null;
+ const year = (h.textContent || "").trim();
+ const count = countListItemsBetween(h, next);
+ return { year, count, targetId: h.id };
+ });
+
+ buildChart(data);
+
+ // active state op basis van URL hash (als je direct naar #year-2024 gaat)
+ const hash = (window.location.hash || "").replace("#", "");
+ const activeFromHash = hash.startsWith("year-") ? hash.replace("year-", "") : null;
+
+ if (activeFromHash) setActiveYear(activeFromHash);
+ else setActiveYear(data[0].year); // default: eerste jaar
+
+ // highlight aanpassen tijdens scroll (optional maar nice)
+ const observer = new IntersectionObserver(
+ (entries) => {
+ // pak de meest zichtbare year heading
+ const visible = entries
+ .filter((e) => e.isIntersecting)
+ .sort((a, b) => b.intersectionRatio - a.intersectionRatio)[0];
+
+ if (visible && visible.target) {
+ const y = (visible.target.textContent || "").trim();
+ if (/^\d{4}$/.test(y)) setActiveYear(y);
+ }
+ },
+ { root: null, threshold: [0.25, 0.5, 0.75] }
+ );
+
+ headings.forEach((h) => observer.observe(h));
+ }
+
+ document.addEventListener("DOMContentLoaded", function () {
+ init();
+ // nog een paar keer: sommige themes renderen content later
+ setTimeout(init, 250);
+ setTimeout(init, 1000);
+ });
+})();
\ No newline at end of file
diff --git a/docs/change-log.md b/docs/change-log.md
new file mode 100644
index 0000000..e621dbb
--- /dev/null
+++ b/docs/change-log.md
@@ -0,0 +1,265 @@
+---
+title: Change log
+nav_order: 1
+description: "Change log for MuscleMap code as released in main Github page"
+parent: Developer section
+permalink: /change-log/
+---
+
+## Change log and model updates
+
+Segmentation models in MuscleMap are periodically retrained on expanded and more diverse datasets to optimise performance, robustness, and cross-site generalisability.
+
+All notable changes to **MuscleMap** are listed below.
+Source: [GitHub Releases](https://github.com/MuscleMap/MuscleMap/releases)
+
+
+
+
+ v2.0
+
+ Latest
+
+
+
+
+
+
+
Refactors MuscleMap to load model parameters and template NIfTI files directly from Zenodo instead of bundling them in the repository
+
Added Zenodo download logic in mm_util.py with support for multiple Zenodo versions
+
Updated mm_gui.py and mm_segment.py to use the new Zenodo-based model loading
+
Added mm_qc_gui.py as a new QC interface
+
Updated setup.py and requirements.txt for v2.0 dependencies
+
Updated .gitignore to exclude large model files
+
Updated README.md with instructions for Zenodo usage and template file setup
+
+
+
+
+
+ v1.3
+
+
+
+
+
+
Included auto chunking to estimate a safe chunk size from currently available CPU or GPU memory and keeps extra headroom to reduce OOM failures
+
Included new model parameters
+
Included extra spatial padding to preserve higher accuracy at muscle boundaries in cropped images
+
Note: Model weights (.pth) and configuration files (.json) for mm_segment have been removed from the git history to reduce repository size. To use this release, download the model parameters from Zenodo and place them in the corresponding subfolder, e.g. scripts/models/wholebody/ or scripts/models/abdomen/
+
Note: Template images (.nii.gz) for mm_register_to_template have been removed from the git history to reduce repository size. To use this release, download the template images from Zenodo and place them in the corresponding subfolder, e.g. scripts/templates/abdomen/
+
+
+
+
+
+
+ v1.2
+
+
+
+
+
+
Included 10 more muscles in wholebody model (left and right pectineus, obturator externus, obturator internus, piriformis, gemelli and quadratus femoris)
+
Included more training data for wholebody model
+
+
+
+
+
+
+ v1.1
+
+
+
+
+
+
Trained whole-body model on a more diverse dataset to improve generalizability
+
Now using foreground cropping to improve inference efficiency
+
+
+
+
+
+
+
+ v1.0
+
+
+
+
+
+
Added the whole-body segmentation model (v1.0)
+
Improved handling of large images in mm_segment
+
Added new options to mm_segment
+
Cleaned and improved mm_extract_metrics
+
+
+
+
+
+
+
+
+ v0.3
+
+ Pre-release
+
+
+
+
+
+
+
Introduced version numbers for trained models
+
Preparation for the v1.0 release
+
+
+
+
+
+
+
+
+ v0.2
+
+ Pre-release
+
+
+
+
+
+
+
Added mm_register_to_template for anatomical registration
+
+
+
+
+
+
+
+
+ v0.1
+
+ Pre-release
+
+
+
+
+
+
+
Initial public pre-release including:
+
+
mm_segment
+
mm_extract_metrics
+
mm_gui
+
+
+
+
+
+
+
+
+
+ v0.0
+
+ Pre-release
+
+
+
+
+
+
+
Initial repository version with early segmentation tools
+
+
+
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/cite.md b/docs/cite.md
new file mode 100644
index 0000000..8e93b1c
--- /dev/null
+++ b/docs/cite.md
@@ -0,0 +1,274 @@
+---
+title: Citing MuscleMap
+nav_order: 4
+description: "Instructions how to cite MuscleMap when utilizing the open-source models"
+parent: User section
+permalink: /cite/
+---
+
+## Citing MuscleMap
+
+### Main reference
+
+When citing **MuscleMap**, please cite the following article:
+
+
+
+ McKay MJ, Weber KA 2nd, Wesselink EO, Smith ZA, Abbott R, Anderson DB, Ashton-James CE,
+ Atyeo J, Beach AJ, Burns J, Clarke S, Collins NJ, Coppieters MW, Cornwall J, Crawford RJ,
+ De Martino E, Dunn AG, Eyles JP, Feng HJ, Fortin M, Franettovich Smith MM, Galloway G,
+ Gandomkar Z, Glastras S, Henderson LA, Hides JA, Hiller CE, Hilmer SN, Hoggarth MA, Kim B,
+ Lal N, LaPorta L, Magnussen JS, Maloney S, March L, Nackley AG, O'Leary SP, Peolsson A,
+ Perraton Z, Pool-Goudzwaard AL, Schnitzler M, Seitz AL, Semciw AI, Sheard PW, Smith AC,
+ Snodgrass SJ, Sullivan J, Tran V, Valentin S, Walton DM, Wishart LR, Elliott JM.
+ MuscleMap: An Open-Source, Community-Supported Consortium for Whole-Body Quantitative
+ MRI of Muscle. J Imaging. 2024;10(11):262.
+
+
+---
+
+### Citing the MuscleMap Toolbox
+
+When using specific components of the **MuscleMap Toolbox**, please cite the relevant methods papers below.
+
+> **Tip:** each reference includes a *Download BibTeX* button that exports the corresponding entry.
+
+
+
+
MuscleMap module
+
References
+
+
+
+
+
+
mm_segment
+
+
+
+ Whole-body —
+ Wesselink EO, Elliott JM, McKay M, de Martino E, Caplan N, Mackey S,
+ Cohen-Adad J, Bédard S, De Leener B, Naga Karthik E, Law CSW, Fortin M,
+ Vleggeert–Lankamp C, Di Leva A, Kim B, Hancock M, Pool-Goudzwaard A,
+ Pevenage P, Weber II KA.
+ Segment-Any-Muscle: Towards an Open-Source, Contrast-Agnostic Computer-Vision
+ Muscle Segmentation Model for MRI and CT.
+ ISMRM 2025 abstract.
+
+ Abdomen —
+ Wesselink EO, Pool-Goudzwaard A, De Leener B, Law CSW, Fenyo MB, Ello GM,
+ Coppieters MW, Elliott JM, Mackey S, Weber KA 2nd.
+ Investigating the associations between lumbar paraspinal muscle health and
+ age, BMI, sex, physical activity, and back pain using an automated
+ computer-vision model: a UK Biobank study.
+ Spine J. 2024;24(7):1253–1266.
+
+ Wesselink EO, Elliott JM, Coppieters MW, Hancock MJ, Cronin B,
+ Pool-Goudzwaard A, Weber II KA.
+ Convolutional neural networks for the automatic segmentation of lumbar
+ paraspinal muscles in people with low back pain.
+ Sci Rep. 2022;12(1):13485.
+
+ Pelvis —
+ Wesselink EO, Elliott JM, McKay M, de Martino E, Caplan N, Mackey S,
+ Cohen-Adad J, Bédard S, De Leener B, Naga Karthik E, Law CSW, Fortin M,
+ Vleggeert–Lankamp C, Di Leva A, Kim B, Hancock M, Pool-Goudzwaard A,
+ Pevenage P, Weber II KA.
+ Segment-Any-Muscle: Towards an Open-Source, Contrast-Agnostic Computer-Vision
+ Muscle Segmentation Model for MRI and CT.
+ ISMRM 2025 abstract.
+
+ Thigh —
+ Wesselink EO, Elliott JM, McKay M, de Martino E, Caplan N, Mackey S,
+ Cohen-Adad J, Bédard S, De Leener B, Naga Karthik E, Law CSW, Fortin M,
+ Vleggeert–Lankamp C, Di Leva A, Kim B, Hancock M, Pool-Goudzwaard A,
+ Pevenage P, Weber II KA.
+ Segment-Any-Muscle: Towards an Open-Source, Contrast-Agnostic Computer-Vision
+ Muscle Segmentation Model for MRI and CT.
+ ISMRM 2025 abstract.
+
+ Leg —
+ Wesselink EO, Elliott JM, McKay M, de Martino E, Caplan N, Mackey S,
+ Cohen-Adad J, Bédard S, De Leener B, Naga Karthik E, Law CSW, Fortin M,
+ Vleggeert–Lankamp C, Di Leva A, Kim B, Hancock M, Pool-Goudzwaard A,
+ Pevenage P, Weber II KA.
+ Segment-Any-Muscle: Towards an Open-Source, Contrast-Agnostic Computer-Vision
+ Muscle Segmentation Model for MRI and CT.
+ ISMRM 2025 abstract.
+
+ Smith AC, Muñoz Laguna J, Wesselink EO, Scott ZE, Jenkins H, Thornton W,
+ Wasielewski M, Connor J, Delp S, Chaudhari A, Parrish TB, Mackey S,
+ Elliott JM, Weber II KA.
+ Leg Muscle Volume, Intramuscular Fat, and Force Generation:
+ Insights from a Computer Vision Model and Fat-Water MRI.
+ J Cachexia Sarcopenia Muscle. 2025;16(1):e13735.
+
+ Wesselink EO, Elliott JM, Pool-Goudzwaard A, Coppieters MW, Pevenage PP,
+ Di Ieva A, Weber II KA.
+ Quantifying lumbar paraspinal intramuscular fat: Accuracy and reliability
+ of automated thresholding models.
+ N Am Spine Soc J. 2024;17:100313.
+
+ Weber KA 2nd, Wesselink EO, Gutierrez J, Law CSW, Mackey S, Ratliff J,
+ Hu S, Chaudhari AS, Pool-Goudzwaard A, Coppieters MW, Elliott JM,
+ Hancock M, De Leener B.
+ Three-dimensional spatial distribution of lumbar paraspinal
+ intramuscular fat revealed by spatial parametric mapping.
+ Eur Spine J. 2025;34(1):27–35.
+
+ Run MuscleMap directly in your browser through Neurodesk.
+ Simply drag and drop NIfTI or DICOM images and click run segmentation.
+ No installation required and all data remains on your local workstation.
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 0000000..51a0c46
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,170 @@
+---
+title: Installation
+nav_order: 1
+parent: User section
+permalink: /installation/
+---
+
+## Installation
+
+This guide explains how to install MuscleMap and its dependencies for automated muscle segmentation and quantification from MRI and CT scans.
+
+
+
+
+
+---
+
+### Dependencies
+
+- **Python:** 3.11.8
+- **Operating system:** Linux, macOS, or Windows
+
+The MuscleMap Toolbox works on **CPU and GPU**, but performance is substantially faster with GPU acceleration.
+
+---
+
+### 1. Install Anaconda
+
+We recommend installing **Miniconda** or **Anaconda** through the following links:
+
+- Miniconda
+- Anaconda
+
+---
+### 2. Create and activate a conda environment
+
+```bash
+conda create --name MuscleMap python=3.11.8
+conda activate MuscleMap
+```
+
+---
+### 3. Download the MuscleMap repository
+
+### Option A — Using Git
+
+```bash
+git clone https://github.com/MuscleMap/MuscleMap.git
+cd MuscleMap
+```
+
+### Option B — Download ZIP
+
+1. Open https://github.com/MuscleMap/MuscleMap
+2. Click the green **<> Code ▼** button
+3. Click **Download ZIP**
+4. Unzip the archive
+5. Navigate to the extracted folder:
+
+```bash
+cd MuscleMap
+```
+---
+
+### 4. Install MuscleMap in editable mode
+
+```bash
+pip install -e .
+```
+
+This installs all required packages and registers the command-line tools:
+
+- `mm_segment`
+- `mm_extract_metrics`
+- `mm_register_to_template`
+- `mm_gui`
+
+
+ Note
+Installing MuscleMap includes a default CPU-only installation of PyTorch. If you want to use a GPU for faster inference, please proceed to Step 5.
+
+
+---
+
+### 5. (Optional) Install PyTorch with GPU support
+
+If you plan to run MuscleMap **on CPU only**, you may skip this step.
+
+To use a GPU, you need one of the following:
+
+- **NVIDIA GPU** with a compatible CUDA runtime
+- **AMD GPU** with ROCm support
+
+### Step 5.1 — Check if CUDA is already available
+
+Open a Python console:
+
+```python
+import torch
+print("Is CUDA available?:", torch.cuda.is_available())
+```
+
+- `True` → CUDA is available and ready
+- `False` → continue with the steps below
+
+---
+### Step 5.2 — Check your system GPU runtime
+
+In a terminal, run:
+
+**NVIDIA (CUDA):**
+```bash
+nvidia-smi
+```
+
+**AMD (ROCm):**
+```bash
+rocm-smi
+```
+
+This tells you which CUDA or ROCm version your system supports.
+
+---
+
+### Step 5.3 — Install a compatible PyTorch version
+
+Install **PyTorch** matching your system configuration.
+
+We recommend using `pip` and following the official PyTorch instructions.
+
+Find the Pytorch installation here
+
+Example (CUDA, adjust version as needed):
+
+```bash
+pip install torch==2.4.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
+```
+
+
+ Note
+ Make sure the CUDA version of PyTorch matches the CUDA runtime reported by nvidia-smi. Also, we recommend to install Pytorch using the wheel.
+
+
+---
+
+### 6. Verify the installation
+
+Run:
+
+```bash
+mm_segment --help
+mm_extract_metrics --help
+mm_register_to_template --help
+mm_gui --help
+```
+
+If these commands print a help message instead of an error, the installation was successful. If you still find problems with installation, please open a [GitHub issue](https://github.com/MuscleMap/MuscleMap/issues) with an example.
+
+---
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/key-features.md b/docs/key-features.md
new file mode 100644
index 0000000..2465c8a
--- /dev/null
+++ b/docs/key-features.md
@@ -0,0 +1,35 @@
+---
+title: Key features
+nav_order: 2
+parent: User section
+description: "Command line tools for utilizing Musclemap (segmentation, fat and muscle volume quantificationa and template registration)"
+has_children: true
+permalink: /key-features/
+toc: false
+---
+
+## Key features
+
+MuscleMap provides four command-line tools:
+* `mm_segment` for generating whole-body muscle and bone segmentations,
+* `mm_extract_metrics` for computing region-wise quantitative metrics for muscle volume and intramuscular fat,
+* `mm_register_to_template` to conduct standardized analysis for the 3D spatial distribution of intramuscular fat,
+* `mm_gui` for visual inspection and quality control.
+
+
+ ← Back to MuscleMap overview
+
+
+
+A video demonstration is provided below.
+
+
+
+
diff --git a/docs/muscle-anatomy.md b/docs/muscle-anatomy.md
new file mode 100644
index 0000000..05ac446
--- /dev/null
+++ b/docs/muscle-anatomy.md
@@ -0,0 +1,122 @@
+---
+title: Anatomical Labels
+nav_order: 3
+description: "MuscleMap anatomical structures for automated muscle and bone segmentation and quantification"
+parent: User section
+permalink: /muscle-anatomy/
+---
+
+## MuscleMap anatomical labels for automated muscle segmentation and quantification
+
+MuscleMap provides automated segmentation and quantfication (muscle volume, intramuscular fat and/or intensity) of 99 muscles and bones across the neck, thorax, abdomen, pelvis, thigh, and leg.
+
+The table below lists all anatomical structures included in the latest version of MuscleMap, together with their label values and laterality. These labels are consistent across all MuscleMap tools (mm_segment, mm_extract_metrics, mm_register_to_template and mm_gui).
+
+| Region | Anatomy | Side | Value |
+| -------- | ------------------------------------ | ------- | -------- |
+| neck | levator scapulae | left | 1101 |
+| neck | levator scapulae | right | 1102 |
+| neck | semispinalis cervicis and multifidus | left | 1111 |
+| neck | semispinalis cervicis and multifidus | right | 1112 |
+| neck | semispinalis capitis | left | 1121 |
+| neck | semispinalis capitis | right | 1122 |
+| neck | splenius capitis | left | 1131 |
+| neck | splenius capitis | right | 1132 |
+| neck | sternocleidomastoid | left | 1141 |
+| neck | sternocleidomastoid | right | 1142 |
+| neck | longus colli | left | 1151 |
+| neck | longus colli | right | 1152 |
+| neck | trapezius | left | 1161 |
+| neck | trapezius | right | 1162 |
+| shoulder | supraspinatus | left | 2101 |
+| shoulder | supraspinatus | right | 2102 |
+| shoulder | subscapularis | left | 2111 |
+| shoulder | subscapularis | right | 2112 |
+| shoulder | infraspinatus | left | 2121 |
+| shoulder | infraspinatus | right | 2122 |
+| shoulder | deltoid | left | 2141 |
+| shoulder | deltoid | right | 2142 |
+| thorax | rhomboid | left | 4101 |
+| thorax | rhomboid | right | 4102 |
+| abdomen | thoracolumbar multifidus | left | 5101 |
+| abdomen | thoracolumbar multifidus | right | 5102 |
+| abdomen | erector spinae | left | 5111 |
+| abdomen | erector spinae | right | 5112 |
+| abdomen | psoas major | left | 5121 |
+| abdomen | psoas major | right | 5122 |
+| abdomen | quadratus lumborum | left | 5131 |
+| abdomen | quadratus lumborum | right | 5132 |
+| abdomen | lattisimus dorsi | left | 5141 |
+| abdomen | lattisimus dorsi | right | 5142 |
+| pelvis | gluteus minimus | left | 6101 |
+| pelvis | gluteus minimus | right | 6102 |
+| pelvis | gluteus medius | left | 6111 |
+| pelvis | gluteus medius | right | 6112 |
+| pelvis | gluteus maximus | left | 6121 |
+| pelvis | gluteus maximus | right | 6122 |
+| pelvis | tensor fascia latae | left | 6131 |
+| pelvis | tensor fascia latae | right | 6132 |
+| pelvis | iliacus | left | 6141 |
+| pelvis | iliacus | right | 6142 |
+| pelvis | ilium | left | 6151 |
+| pelvis | ilium | right | 6152 |
+| pelvis | sacrum | no side | 6160 |
+| pelvis | femur | left | 6171 |
+| pelvis | femur | right | 6172 |
+| pelvis | piriformis | left | 6181 |
+| pelvis | piriformis | right | 6182 |
+| pelvis | pectineus | left | 6191 |
+| pelvis | pectineus | right | 6192 |
+| pelvis | obturator internus | left | 6201 |
+| pelvis | obturator internus | right | 6202 |
+| pelvis | obturator externus | left | 6211 |
+| pelvis | obturator externus | right | 6212 |
+| pelvis | gemelli and quadratus femoris | left | 6221 |
+| pelvis | gemelli and quadratus femoris | right | 6222 |
+| thigh | vastus lateralis | left | 7101 |
+| thigh | vastus lateralis | right | 7102 |
+| thigh | vastus intermedius | left | 7111 |
+| thigh | vastus intermedius | right | 7112 |
+| thigh | vastus medialis | left | 7121 |
+| thigh | vastus medialis | right | 7122 |
+| thigh | rectus femoris | left | 7131 |
+| thigh | rectus femoris | right | 7132 |
+| thigh | sartorius | left | 7141 |
+| thigh | sartorius | right | 7142 |
+| thigh | gracilis | left | 7151 |
+| thigh | gracilis | right | 7152 |
+| thigh | semimembranosus | left | 7161 |
+| thigh | semimembranosus | right | 7162 |
+| thigh | semitendinosus | left | 7171 |
+| thigh | semitendinosus | right | 7172 |
+| thigh | biceps femoris long head | left | 7181 |
+| thigh | biceps femoris long head | right | 7182 |
+| thigh | biceps femoris short head | left | 7191 |
+| thigh | biceps femoris short head | right | 7192 |
+| thigh | adductor magnus | left | 7201 |
+| thigh | adductor magnus | right | 7202 |
+| thigh | adductor longus | left | 7211 |
+| thigh | adductor longus | right | 7212 |
+| thigh | adductor brevis | left | 7221 |
+| thigh | adductor brevis | right | 7222 |
+| leg | anterior compartment | left | 8101 |
+| leg | anterior compartment | right | 8102 |
+| leg | deep posterior compartment | left | 8111 |
+| leg | deep posterior compartment | right | 8112 |
+| leg | lateral compartment | left | 8121 |
+| leg | lateral compartment | right | 8122 |
+| leg | soleus | left | 8131 |
+| leg | soleus | right | 8132 |
+| leg | gastrocnemius | left | 8141 |
+| leg | gastrocnemius | right | 8142 |
+| leg | tibia | left | 8151 |
+| leg | tibia | right | 8152 |
+| leg | fibula | left | 8161 |
+| leg | fibula | right | 8162 |
+
+
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/muscle-quantification.md b/docs/muscle-quantification.md
new file mode 100644
index 0000000..f0340a9
--- /dev/null
+++ b/docs/muscle-quantification.md
@@ -0,0 +1,267 @@
+---
+title: Quantification
+parent: Key features
+description: "MuscleMap’s mm_extract_metrics performs quantitative muscle analysis from MRI and CT, including muscle volume, cross-sectional area, intramuscular fat infiltration, and CT muscle density from deep learning–based whole-body segmentation."
+grand_parent: User section
+nav_order: 2
+permalink: /muscle-quantification/
+---
+
+
+
+
+
Key feature
+
Automated muscle quantification
+
+ MuscleMap's `mm_extract_metrics` is the command-line tool for quantitative muscle analysis, enabling automated estimation of muscle volume, cross-sectional area (CSA), intramuscular fat infiltration, and muscle density from MRI and CT images.
+
+
+It supports Gaussian Mixture Models (GMM), K-means clustering for T1 and T2-weighted MRI, fat fraction for Dixon MRI and HU‑based fat quantification for CT in customizable (.csv) output formats.
+
+This page explains:
+
+- how `mm_extract_metrics` works
+- all key command-line options
+- recommended workflows
+- output files and their interpretation
+- troubleshooting guidance
+
+> **Tip:** For the most up-to-date options in your installed version, run:
+> ```bash
+> mm_extract_metrics --help
+> ```
+
+---
+
+### 1. Basic usage
+
+After generating a segmentation with `mm_segment`, run:
+
+```bash
+mm_extract_metrics -m gmm -r wholebody -i image.nii.gz -s image_dseg.nii.gz -c 3
+```
+
+This command:
+
+- loads the image (`-i`)
+- loads the segmentation (`-s`)
+- applies the chosen metric method (`-m`)
+- computes fat/water composition or tissue-specific statistics
+- outputs CSV + NIfTI metric maps (depending on options)
+
+---
+
+### 2. Required inputs
+
+### 2.1 `-i` — Input image
+
+The MRI/CT image from which metrics are extracted:
+
+```bash
+mm_extract_metrics -i sub-01_T2w.nii.gz
+```
+
+### 2.2 `-s` — Muscle segmentation labelmap
+
+The muscle segmentation labelmap produced by `mm_segment` or from manual segmentation:
+
+```bash
+mm_extract_metrics -s sub-01_dseg.nii.gz
+```
+
+
+ Warning
+The segmentation must contain the same dimensions and orientation as the input image.
+
+
+### 2.3 `-o` — Output directory
+Output directory to save the results from `mm_extract_metrics`. If not specified, the results are saved in the same directory as the input image.
+
+---
+
+### 3. Metric computation methods (`-m`)
+
+The `-m` flag determines how fat fraction / composition metrics are computed.
+
+Supported values:
+
+
+### 1. `Dixon` — Fat–water–based metrics
+Uses Dixon-based fat and water separation to compute voxel-wise fat fraction and derive muscle composition metrics within the muscle segmentation.
+
+```bash
+mm_extract_metrics -m dixon -f fat.nii.gz -w water.nii.gz -s img_dseg.nii.gz
+```
+
+### 2. `gmm` — Gaussian Mixture Model (MRI)
+Uses a Gaussian Mixture Model (GMM) to separate tissue types by fitting multiple Gaussian distributions to the intensity histogram and classifying voxels based on their intensity-derived probabilities.
+
+```bash
+mm_extract_metrics -m gmm -i img.nii.gz -s img_dseg.nii.gz
+```
+### 3. `kmeans` — Kmeans clustering (MRI)
+Uses k-means clustering to partition voxels into intensity-based clusters by minimizing within-cluster variance, assigning each voxel to the nearest cluster centroid (e.g., fat vs. muscle) based on its intensity.
+
+```bash
+mm_extract_metrics -m kmeans -i img.nii.gz -s img_dseg.nii.gz
+```
+
+ Warning
+ Use GMM and/or K-means clustering on T1-weighted or T2-weighted MRI only.
+
+
+### 4. `average` — Density metrics
+An averaging-based method to quantify muscle density by computing the mean voxel signal intensity within the muscle region..
+
+```bash
+mm_extract_metrics -m average -i ct_img.nii.gz -s ct_dseg.nii.gz
+```
+
+
+ Warning
+ Use `average` metrics preferably for CT. MRI intensities do not reflect physical density.
+
+---
+
+### 4. Region selection (`-r`)
+
+Choose which muscle regions to extract metrics for.
+
+Example:
+
+```bash
+mm_extract_metrics -r wholebody
+```
+
+Common values include:
+
+- `wholebody` (default)
+- `abdomen`
+- `pelvis`
+- `thigh`
+- `leg`
+
+Regions correspond to MuscleMap's anatomical label groups.
+
+
+ Note
+ Region definitions are based on the
+ MuscleMap atlas
+ and segmentation model.
+
+
+---
+
+### 5. Number of clusters (`-c`)
+
+Used only with GMM or Kmeans and T1- or T2-weighted MRI.
+
+Example for 3 clusters:
+
+```bash
+mm_extract_metrics -c 3
+```
+
+Typical choice:
+
+- 2 clusters: fat vs. muscle
+- 3 clusters: fat, muscle, intermediate tissue
+
+
+ Note
+Intermediate reflects a voxel with intermediate voxel signal not clearly corresponding to either fat or muscle.
+
+
+---
+
+### 6. Output files
+
+`mm_extract_metrics` typically produces:
+
+### 1. CSV file with summary statistics
+Contains per-muscle metrics, dependent on the arguments, such as:
+
+- muscle volume
+- fat fraction
+- average density (e.g., for CT)
+
+### 2. Voxel-wise metric maps (optional depending on method)
+
+Examples:
+
+- Thresholding maps for either GMM or Kmeans and two or three clusters
+
+
+ Note
+The thresholding maps can be loaded as a segmentation to visually check thresholding accuracy
+
+ Warning
+Always **visually inspect both segmentation and metric outputs** before analysis.
+
+
+---
+
+### 9. Summary
+
+`mm_extract_metrics` is the quantitative analysis backbone of MuscleMap:
+
+- accepts MRI or CT images + segmentations
+- computes fat fraction, HU metrics, tissue composition
+- supports GMM, Kmeans, HU-based methods
+- outputs CSV and optional maps
+- integrates with `mm_gui` for streamlined workflows
+
+---
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/muscle-registration.md b/docs/muscle-registration.md
new file mode 100644
index 0000000..22eb9b0
--- /dev/null
+++ b/docs/muscle-registration.md
@@ -0,0 +1,153 @@
+---
+title: Registration
+parent: Key features
+description: "MuscleMap's mm_register_to_template performs anatomical registration of MRI and CT scans to a standard template, enabling spatial normalisation, group comparisons, and voxelwise muscle analysis"
+grand_parent: User section
+nav_order: 3
+permalink: /muscle-registration/
+---
+
+
+## Template-based muscle registration for voxel-wise muscle analysis
+
+`mm_register_to_template` registers an input image and its segmentation to a predefined MuscleMap anatomical template.
+This enables standardized voxel-wise analyses, such as spatial parametric mapping of intramuscular fat, across subjects.
+
+This step is typically performed after segmentation with `mm_segment`.
+
+---
+
+### 1. Basic usage
+
+```bash
+mm_register_to_template -i image.nii.gz -s image_dseg.nii.gz -r abdomen
+```
+
+This command:
+
+- loads the input image (`-i`)
+- loads the corresponding segmentation (`-s`)
+- registers the image and each label to the selected regional template (`-r`)
+- outputs warped images, segmentations, and transformation fields
+
+
+ Warning
+ The segmentation must match the input image dimensions and orientation.
+ Always use the segmentation produced for that exact image.
+
+
+---
+
+### 2. Requirements
+
+### 2.1 Spinal Cord Toolbox
+
+This tool depends on Spinal Cord Toolbox (SCT) and expects:
+
+- SCT version 6.5
+
+
+ Warning
+ MuscleMap’s template registration workflow is developed and tested with
+ Spinal Cord Toolbox 6.5.
+ Other versions may not behave identically.
+
+
+The SCT installation directory must be available via:
+
+```bash
+export SCT_DIR=/path/to/spinalcordtoolbox
+```
+
+---
+
+### 3. How the registration works
+
+For each label in the segmentation (each muscle or structure with label > 0), the following steps are performed:
+
+1. Label extraction
+ A binary mask is created for the current label.
+
+2. Centerline estimation
+ A slice-wise center-of-mass is computed to estimate a label-specific centerline.
+
+3. Initial affine alignment
+ Three landmark points (≈10%, 50%, 90% along the centerline) are used to compute a constrained affine transform, which is applied to:
+ - the input image (linear interpolation)
+ - the label mask (nearest-neighbour interpolation)
+
+4. Nonlinear registration to the template
+ Using `sct_register_multimodal`, the affine-initialized image and label are nonlinearly registered to the template.
+
+5. Warp concatenation and application
+ Final transformation fields are concatenated and applied to generate outputs in template space.
+
+---
+
+### 4. Outputs
+
+For each label, the following files are generated (naming simplified):
+
+- `*_dseg_label-.nii.gz` — binary label mask in native space
+- `*_label-_affine.nii.gz` — image after initial affine alignment
+- `*_dseg_label-_affine.nii.gz` — label after affine alignment
+- `warp_*_affine2_template.nii.gz` — nonlinear warp field
+- `warp_*2_template.nii.gz` — concatenated warp (native → template)
+- `*_label-2_template.nii.gz` — image in template space
+- `*_dseg_label-2_template.nii.gz` — label in template space
+
+---
+
+### 5. Quality control
+
+Always visually inspect registration quality:
+
+```bash
+fsleyes template.nii.gz image_label-2abdomen_template.nii.gz &
+```
+
+Check for:
+
+- correct anatomical alignment
+- absence of flips or large shifts
+- plausible deformation of each label
+
+
+ Warning
+ Registration may fail for very small or noisy labels.
+ Inspect representative labels before group analyses.
+
+ Note
+ Intermediate reflects a voxel with intermediate voxel signal not clearly corresponding to either fat or muscle.
+
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/muscle-segmentation.md b/docs/muscle-segmentation.md
new file mode 100644
index 0000000..79afba0
--- /dev/null
+++ b/docs/muscle-segmentation.md
@@ -0,0 +1,261 @@
+---
+title: Segmentation
+parent: Key features
+description: "MuscleMap's mm_segment performs automatic whole-body muscle and bone segmentation on MRI and CT using deep learning. Supports 89 muscles, intramuscular fat analysis, and quantitative muscle metrics."
+grand_parent: User section
+nav_order: 1
+permalink: /muscle-segmentation/
+---
+
+
+
+
+
Key feature
+
Automated whole-body muscle segmentation
+
+ MuscleMap segmentation is performed using a deep learning–based, contrast-agnostic whole-body model trained for robust muscle and bone segmentation across MRI and CT modalities.
+
+
+This page explains:
+
+- how to run segmentation module: `mm_segment`
+- all available options and flags
+- whole-body vs. regional models
+- recommended workflows
+- troubleshooting tips
+
+**Tip:** For the most up-to-date list of options in your installation, run:
+
+ ```bash
+ mm_segment --help
+ ```
+
+---
+
+### 1. Basic usage
+
+### 1.1 Activate the MuscleMap environment
+
+```bash
+conda activate MuscleMap
+```
+
+### 1.2 Run `mm_segment` on a single NIfTI image
+
+First, navigate to the directory containing your input image (or provide the full path to the file):
+
+```bash
+cd /path/to/your/data
+```
+
+Then run:
+```bash
+mm_segment -i image.nii.gz
+```
+
+This command:
+
+- loads the input image
+- applies the default whole-body segmentation model
+- writes a segmentation labelmap (NIfTI) next to the input file
+- prints output paths and logs to the terminal
+
+
+ Warning
+ Running mm_segment from the command line works as expected when MuscleMap is installed in editable mode (pip install -e .).
+ If the package was installed using pip install ., it may be preferable to run the script directly using python mm_segment.py.
+
+
+---
+
+### 2. Input requirements
+
+### 2.1 Supported image types
+
+- **Modality:** Axial MRI of any contrast (T1w, T2w, Dixon water/fat/in-phase) or CT
+- **Format:** NIfTI (`.nii`, `.nii.gz`)
+- **Orientation:** Axial orientation recommended
+
+MuscleMap recommends storing data in **BIDS format** with **JSON sidecars** from `dcm2niix`.
+
+### 2.2 Processing single images vs. datasets
+
+`mm_segment` processes **one image at a time**.
+
+For multiple images:
+
+- loop through images in shell/Python
+- keep consistent naming using BIDS
+
+---
+
+### 3. Output
+
+`mm_segment` generates deep learning–based whole-body muscle segmentation outputs, including:
+
+- a **segmentation labelmap** (NIfTI) with integer labels
+- an output file saved next to the input
+- terminal logs with paths and runtime info
+
+Visualise results in:
+
+- [ITK-SNAP](https://www.itksnap.org/pmwiki/pmwiki.php)
+- [3D Slicer](https://www.slicer.org/)
+- [FSLeyes](https://open.oxcin.ox.ac.uk/pages/fslcourse/practicals/intro1/index.html)
+
+---
+### 4. Models and regions
+
+### 4.1 Whole-body model (default)
+
+```bash
+mm_segment -i image.nii.gz
+```
+
+Segments:
+
+- trunk muscles
+- pelvic muscles
+- thigh muscles
+- leg muscles
+- neck muscles
+- selected bones
+
+### 4.2 Legacy regional models
+
+Available:
+
+- `abdomen`
+- `pelvis`
+- `thigh`
+- `leg`
+
+Example:
+
+```bash
+mm_segment -i image.nii.gz -r abdomen
+```
+
+
+ Warning
+The legacy regional models are maintained for backward compatibility only.
+Active development and state-of-the-art performance are provided exclusively by the whole-body model, which achieves robust performance across all anatomical regions.
+
+ Note
+Lower sliding-window overlap increases inference speed but may reduce segmentation performance, particularly near tile boundaries.
+Higher overlap improves robustness at the cost of longer runtimes.
+
+
+### 5.3 `-r` — region model
+
+```bash
+mm_segment -i image.nii.gz -r thigh
+```
+
+### 5.4 `-g` — GPU/CPU selection
+
+Controls whether inference is performed on the GPU or CPU.
+
+Example:
+
+```bash
+mm_segment -i image.nii.gz -g Y
+```
+
+
+ Note
+By default, MuscleMap runs inference on the **GPU** when available.
+Use `-g N` to explicitly force CPU-based inference.
+
+
+
+### 5.5 `-h` — help
+
+```bash
+mm_segment -h
+```
+
+---
+
+### 6. Example workflows
+
+### 6.1 Whole-body segmentation
+
+```bash
+mm_segment -i sub-01_water.nii.gz
+```
+
+### 6.2 Faster inference
+
+```bash
+mm_segment -i sub-02_T2w.nii.gz -s 50
+```
+
+### 6.3 Using a regional model
+
+```bash
+mm_segment -i sub-03_T2w.nii.gz -r abdomen
+```
+
+### 6.4 Full pipeline with metrics
+
+```bash
+mm_segment -i image.nii.gz
+mm_extract_metrics -m gmm -r wholebody -i image.nii.gz -s image_dseg.nii.gz -c 3
+```
+---
+
+See the [Muscle quantification and metric extraction](../muscle-quantification/) page for details on muscle volume and fat infiltration analysis.
+
+### 7. Best practices & troubleshooting
+
+- Always visually inspect segmentations
+- Poor image quality reduces accuracy
+- Record MuscleMap version and options in publications
+
+If something looks wrong:
+
+- open a [GitHub issue](https://github.com/MuscleMap/MuscleMap/issues) with an example
+
+---
diff --git a/docs/musclemap_publications.bib b/docs/musclemap_publications.bib
new file mode 100644
index 0000000..99ad71f
--- /dev/null
+++ b/docs/musclemap_publications.bib
@@ -0,0 +1,393 @@
+@article{Aydin2026CervicalParaspinal,
+ title = {Cervical Paraspinal Muscle Morphometry and Mechanical Failure: A Propensity-Matched Analysis},
+ author = {Aydin, Serhat and Carnovale, Benjamin J. and Wakelin, Samuel H. and Manov, Armani and Waheed, Ayesha Akbar and Adida, Samuel and Shanahan, Regan M. and Legarreta, Andrew and Zeeshan, Qazi and Hamilton, David Kojo and Agarwal, Nitin},
+ journal = {World Neurosurgery},
+ year = {2026},
+ volume = {211},
+ number = {},
+ pages = {125035},
+ doi = {10.1016/j.wneu.2026.125035},
+ url = {https://doi.org/10.1016/j.wneu.2026.125035},
+ note = {Published 2026}
+}
+
+@article{Guo2026FrailtyMuscle,
+ title = {Frailty-Muscle Phenotypes Predict Outcomes After Lumbar Fusion in Adults Aged ≥75 Years: A Retrospective Cohort Study},
+ author = {Guo, MaChao and Li, Xiangyu and Wang, Shuaikang and Chen, Xiaolong and Kong, Chao and Liu, Yuxi and Lu, Shibao},
+ journal = {Neurospine},
+ year = {2026},
+ volume = {23},
+ number = {2},
+ pages = {242--254},
+ doi = {10.14245/ns.2551838.919},
+ url = {https://doi.org/10.14245/ns.2551838.919},
+ note = {Published 30 April 2026}
+}
+
+@article{Montpetit2026AquaticTherapy,
+ title = {Effects of aquatic therapy vs. standard care on gluteal muscle morphology and function in individuals with chronic low back pain: a randomized controlled trial},
+ author = {Montpetit, Chanelle and Vaillancourt, Nicolas and Rosenstein, Brent and Wesselink, Evert Onno and Dover, Geoffrey and Weiss, Christina and Papula, Lee Ann and Melek, Antonys and Weber, Kenneth Arnold and Elliott, James M. and Fortin, Maryse},
+ journal = {BMC Sports Science, Medicine and Rehabilitation},
+ year = {2026},
+ volume = {},
+ number = {},
+ pages = {},
+ doi = {10.1186/s13102-026-01666-0},
+ url = {https://doi.org/10.1186/s13102-026-01666-0},
+ note = {Article in Press; accepted 20 March 2026}
+}
+
+@article{Guo2026ParaspinalRadiomics,
+ title = {Paraspinal muscle MRI radiomics outperform disc radiomics for predicting poor disability improvement after L4/5 single-level lumbar surgery},
+ author = {Guo, Machao and Li, Xiangyu and Liu, Yuxi and Lu, Shibao},
+ journal = {European Spine Journal},
+ year = {2026},
+ volume = {},
+ number = {},
+ pages = {},
+ doi = {10.1007/s00586-026-09801-8},
+ url = {https://link.springer.com/article/10.1007/s00586-026-09801-8},
+ note = {Published 13 February 2026}
+}
+
+@article{Guo2026RadiomicsLOS,
+ title = {L1-S1 Posterior Paraspinal Muscle Fatty Infiltration and a Radiomics Signature Predict Prolonged Length of Stay After Lumbar Spine Surgery in Older Adults},
+ author = {Guo, MaChao and Wang, Shuaikang and Li, Xiangyu and Liu, Yuxi and Lu, Shibao},
+ journal = {Spine (Phila Pa 1976)},
+ year = {2026},
+ volume = {51},
+ number = {11},
+ pages = {E283--E292},
+ doi = {10.1097/BRS.0000000000005667},
+ url = {https://doi.org/10.1097/BRS.0000000000005667},
+ note = {Epub 25 February 2026}
+}
+
+@article{SlutskyGanesh2026OptimizingMRI,
+ title = {Optimizing MRI Annotation Workflows for High-Accuracy Deep Learning Models in Radiology},
+ author = {Slutsky-Ganesh, A. B. and others},
+ journal = {Radiology Advances},
+ year = {2026},
+ month = jan,
+ day = {25},
+ volume = {??},
+ number = {??},
+ pages = {??},
+ doi = {10.1093/radadv/umag005},
+ url = {https://doi.org/10.1093/radadv/umag005},
+ note = {Advance online publication}
+}
+
+
+
+@article{Wesselink2026LumbarMultifidus,
+ title = {Lumbar Multifidus Intramuscular Fat Concentrations are Associated With Recovery Following Decompressive Surgery for Lumbar Spinal Stenosis: A Longitudinal Cohort Study With Five-Year Follow-Up},
+ author = {Wesselink, Evert O. and Verheijen, Eduard J. A. and Djuric, Niek and Coppieters, Michel W. and Elliott, James M. and Weber, Kenneth A. and Moojen, Wouter A. and Vleggeert-Lankamp, Carmen L. and Pool-Goudzwaard, Annelies},
+ journal = {Spine (Phila Pa 1976)},
+ year = {2026},
+ month = jan,
+ day = {1},
+ volume = {51},
+ number = {1},
+ pages = {25--33},
+ doi = {10.1097/BRS.0000000000005408},
+ url = {https://doi.org/10.1097/BRS.0000000000005408},
+ note = {Epub 2025 May 27}
+}
+
+@article{Masnoon2026MuscleComposition,
+ title = {Muscle Composition as a Novel Prognostic Tool for Pain, Frailty, and Sarcopenia},
+ author = {Masnoon, Nashwa and Cornwall, Jon and Elliott, James M. and Glare, Paul and Hilmer, Sarah N. and McKay, Marnee and Walton, David M. and Weber, Kenneth A. and Wesselink, Eddo O.},
+ journal = {Clin Geriatr Med},
+ year = {2026},
+ volume = {42},
+ number = {1},
+ pages = {61--73},
+ doi = {10.1016/j.cger.2025.08.012},
+ url = {https://doi.org/10.1016/j.cger.2025.08.012},
+ note = {Epub 2025 Sep 22}
+}
+
+@article{vanAmstel2026EpimuscularFat,
+ title = {Higher Lumbodorsal Epimuscular Fat Associated With Recurrent Low Back Pain: An Exploratory Secondary Analysis of Cross-Sectional MRI Data With 1-Year Follow-Up},
+ author = {van Amstel, Robbert N. and Wesselink, Eddo O. and Weide, Guido and Hooijmans, Melissa T. and Elliott, James M. and Weber II, Kenneth A. and Hancock, Mark J. and Jaspers, Richard T. and Pool-Goudzwaard, Annelies L.},
+ journal = {European Spine Journal},
+ year = {2026},
+ month = jan,
+ day = {5},
+ doi = {10.1007/s00586-025-09620-3},
+ url = {https://doi.org/10.1007/s00586-025-09620-3}
+}
+
+@article{Smulligan2025CervicalMRI,
+ author = {Smulligan, Katherine L. and Smith, Andrew C. and Weber, Kenneth A. and Carry, Patrick and Esopenko, Carrie and Baugh, Christine M. and Elliott, James and Snodgrass, Suzanne and Wesselink, Evert O. and Wilson, Julie and Howell, David L.},
+ title = {A Magnetic Resonance Imaging (MRI) Investigation of Cervical Spine Muscle Characteristics After Concussion: Identifying Return-to-Play Clearance and Subsequent Injury Prognosis},
+ journal = {Journal of Child Neurology},
+ year = {2025},
+ doi = {10.1177/08830738251392519},
+ url = {https://doi.org/10.1177/08830738251392519},
+ note = {Published online November 6, 2025},
+ publisher = {SAGE}
+}
+
+@article{Nim2025SpinalStiffness,
+ author = {Nim, Casper and Weber II, Kenneth A. and O’Neill, S{\o}ren and Paulsen, Rune Tendal and Culmsee-Holm, Liam and Wesselink, Evert Onno and Sun, Yue-Li and Jun, Peter and Breen, Alexander and Kawchuk, Gregory N.},
+ title = {The relation between bulk (external) and internal measures of spinal stiffness},
+ journal = {Chiropractic \& Manual Therapies},
+ volume = {33},
+ number = {1},
+ pages = {52},
+ year = {2025},
+ doi = {10.1186/s12998-025-00615-x},
+ url = {https://doi.org/10.1186/s12998-025-00615-x},
+ publisher = {BioMed Central},
+ note = {Published 19 November 2025}
+}
+
+@article{Fundaun2025ForearmSegmentation,
+ author = {Fundaun, J. and Oliva, V. and B{\'e}dard, S. and Wesselink, E. O. and Lynn, B. P. and Pai, S. A. and Pfyffer, D. and Kaptan, M. and Berhe, N. and Ratliff, J. and Hu, S. S. and Smith, Z. A. and Hastie, T. J. and Mackey, S. and McKay, M. J. and Elliott, J. M. and Delp, S. L. and Chaudhari, A. S. and Law, C. S. W. and Weber, K. A.},
+ title = {Automated Segmentation of Forearm Muscles: Clinical Associations With Hand Function, Muscle Volume and Intramuscular Fat},
+ journal = {JCSM Communications},
+ year = {2025},
+ volume = {8},
+ number = {2},
+ pages = {e70015},
+ doi = {10.1002/rco2.70015},
+ url = {https://doi.org/10.1002/rco2.70015}
+}
+
+@article{Smith2025LegMuscleVolume,
+ author = {Smith, A. C. and Mu{\~n}oz Laguna, J. and Wesselink, E. O. and Scott, Z. E. and Jenkins, H. and Thornton, W. and Wasielewski, M. and Connor, J. and Delp, S. and Chaudhari, A. and Parrish, T. B. and Mackey, S. and Elliott, J. M. and Weber, K. A.},
+ title = {Leg Muscle Volume, Intramuscular Fat, and Force Generation: Insights from a Computer Vision Model and Fat-Water MRI},
+ journal = {Journal of Cachexia, Sarcopenia and Muscle},
+ year = {2025},
+ volume = {16},
+ number = {1},
+ pages = {e13735},
+ doi = {10.1002/jcsm.13735}
+}
+
+@article{Kim2025ShoulderCNN,
+ author = {Kim, B. and Gandomkar, Z. and McKay, M. J. and Seitz, A. L. and Wesselink, E. O. and Cass, B. and Young, A. A. and Linklater, J. M. and Szajer, J. and Subbiah, K. and Elliott, J. M. and Weber, K. A.},
+ title = {Developing a Three-Dimensional Convolutional Neural Network for Full Volume Auto-Segmentation of Shoulder Dixon MRI with Comparison to Goutallier Classification and Two-Dimensional Muscle Quality Assessment},
+ journal = {Journal of Shoulder and Elbow Surgery},
+ year = {2025},
+ note = {In press},
+ doi = {10.1016/j.jse.2024.12.033}
+}
+
+@article{Weber2025SpatialParametric,
+ author = {Weber, K. A. and Wesselink, E. O. and Gutierrez, J. and Law, C. S. W. and Mackey, S. and Ratliff, J. and Hu, S. and Chaudhari, A. S. and Pool-Goudzwaard, A. and Coppieters, M. W. and Elliott, J. M. and Hancock, M. and De Leener, B.},
+ title = {Three-Dimensional Spatial Distribution of Lumbar Paraspinal Intramuscular Fat Revealed by Spatial Parametric Mapping},
+ journal = {European Spine Journal},
+ year = {2025},
+ volume = {34},
+ number = {1},
+ pages = {27--35},
+ doi = {10.1007/s00586-024-08559-1}
+}
+
+@article{Wesselink2025BedRest,
+ author = {Wesselink, E. O. and Hides, J. and Elliott, J. M. and Hoggarth, M. and Weber, K. A. and Salomoni, S. E. and Tran, V. and Lindsay, K. and Hughes, L. and Weber, T. and Scott, J. and Hodges, P. W. and Caplan, N. and De Martino, E.},
+ title = {New Insights into the Impact of Bed Rest on Lumbopelvic Muscles: A Computer-Vision Model Approach to Measure Fat Fraction Changes},
+ journal = {Journal of Applied Physiology},
+ year = {2025},
+ volume = {138},
+ number = {1},
+ pages = {157--168},
+ doi = {10.1152/japplphysiol.00502.2024}
+}
+
+@article{Stewart2024HipPain,
+ author = {Stewart, C. and Wesselink, E. O. and Perraton, Z. and Weber, K. A. and King, M. G. and Kemp, J. L. and Mentiplay, B. F. and Crossley, K. M. and Elliott, J. M. and Heerey, J. J. and Scholes, M. J. and Lawrenson, P. R. and Calabrese, C. and Semciw, A. I.},
+ title = {Muscle Fat and Volume Differences in People With Hip-Related Pain Compared With Controls: A Machine Learning Approach},
+ journal = {Journal of Cachexia, Sarcopenia and Muscle},
+ year = {2024},
+ volume = {15},
+ number = {6},
+ pages = {2642--2650},
+ doi = {10.1002/jcsm.13608}
+}
+
+@article{McKay2024MuscleMapConsortium,
+ author = {McKay, M. J. and Weber, K. A. and Wesselink, E. O. and Smith, Z. A. and Abbott, R. and Anderson, D. B. and Ashton-James, C. E. and Atyeo, J. and Beach, A. J. and Burns, J. and Clarke, S. and Collins, N. J. and Coppieters, M. W. and Cornwall, J. and Crawford, R. J. and De Martino, E. and Dunn, A. G. and Eyles, J. P. and Feng, H. J. and Fortin, M. and Franettovich Smith, M. M. and others},
+ title = {MuscleMap: An Open-Source, Community-Supported Consortium for Whole-Body Quantitative MRI of Muscle},
+ journal = {Journal of Imaging},
+ year = {2024},
+ volume = {10},
+ number = {11},
+ pages = {262},
+ doi = {10.3390/jimaging10110262}
+}
+
+@article{Wesselink2024Biobank,
+ author = {Wesselink, E. O. and Pool-Goudzwaard, A. and De Leener, B. and Law, C. S. W. and Fenyo, M. B. and Ello, G. M. and Coppieters, M. W. and Elliott, J. M. and Mackey, S. and Weber, K. A.},
+ title = {Investigating the Associations Between Lumbar Paraspinal Muscle Health and Age, BMI, Sex, Physical Activity, and Back Pain Using an Automated Computer-Vision Model: A {UK} Biobank Study},
+ journal = {The Spine Journal},
+ year = {2024},
+ volume = {24},
+ number = {7},
+ pages = {1253--1266},
+ doi = {10.1016/j.spinee.2024.02.013}
+}
+
+@article{Wesselink2024Thresholding,
+ author = {Wesselink, E. O. and Elliott, J. M. and Pool-Goudzwaard, A. and Coppieters, M. W. and Pevenage, P. P. and Di Ieva, A. and Weber, K. A.},
+ title = {Quantifying Lumbar Paraspinal Intramuscular Fat: Accuracy and Reliability of Automated Thresholding Models},
+ journal = {North American Spine Society Journal},
+ year = {2024},
+ volume = {17},
+ pages = {100313},
+ doi = {10.1016/j.xnsj.2024.100313}
+}
+
+@article{Perraton2024LateralHip,
+ author = {Perraton, Z. and Mosler, A. B. and Lawrenson, P. R. and Weber, K. A. and Elliott, J. M. and Wesselink, E. O. and Crossley, K. M. and Kemp, J. L. and Stewart, C. and Girdwood, M. and King, M. G. and others},
+ title = {The Association Between Lateral Hip Muscle Size/Intramuscular Fat Infiltration and Hip Strength in Active Young Adults With Long Standing Hip/Groin Pain},
+ journal = {Physical Therapy in Sport},
+ year = {2024},
+ volume = {65},
+ pages = {95--101},
+ doi = {10.1016/j.ptsp.2023.11.007}
+}
+
+@article{Snodgrass2024CervicalRecovery,
+ author = {Snodgrass, S. J. and Weber, K. A. and Wesselink, E. O. and Stanwell, P. and Elliott, J. M.},
+ title = {Reduced Cervical Muscle Fat Infiltrate Is Associated with Self-Reported Recovery from Chronic Idiopathic Neck Pain Over Six Months: A Magnetic Resonance Imaging Longitudinal Cohort Study},
+ journal = {Journal of Clinical Medicine},
+ year = {2024},
+ volume = {13},
+ number = {15},
+ pages = {4485},
+ doi = {10.3390/jcm13154485}
+}
+
+@article{Wesselink2023SystematicReview,
+ author = {Wesselink, E. O. and Pool, J. J. M. and Mollema, J. and Weber, K. A. and Elliott, J. M. and Coppieters, M. W. and Pool-Goudzwaard, A. L.},
+ title = {Is Fatty Infiltration in Paraspinal Muscles Reversible with Exercise in People with Low Back Pain? A Systematic Review},
+ journal = {European Spine Journal},
+ year = {2023},
+ volume = {32},
+ number = {3},
+ pages = {787--796},
+ doi = {10.1007/s00586-022-07471-w}
+}
+
+@article{Wesselink2022CNNLumbar,
+ author = {Wesselink, E. O. and Elliott, J. M. and Coppieters, M. W. and Hancock, M. J. and Cronin, B. and Pool-Goudzwaard, A. and Weber, K. A.},
+ title = {Convolutional Neural Networks for the Automatic Segmentation of Lumbar Paraspinal Muscles in People with Low Back Pain},
+ journal = {Scientific Reports},
+ year = {2022},
+ volume = {12},
+ number = {1},
+ pages = {13485},
+ doi = {10.1038/s41598-022-16710-5}
+}
+
+@article{Bodkin2022MidThigh,
+ author = {Bodkin, S. G. and Smith, A. C. and Bergman, B. C. and Huo, D. and Weber, K. A. and Zarini, S. and Kahn, D. and Garfield, A. and Macias, E. and Harris-Love, M. O.},
+ title = {Utilization of Mid-Thigh Magnetic Resonance Imaging to Predict Lean Body Mass and Knee Extensor Strength in Obese Adults},
+ journal = {Frontiers in Rehabilitation Sciences},
+ year = {2022},
+ volume = {3},
+ pages = {808538},
+ doi = {10.3389/fresc.2022.808538}
+}
+
+@article{Snodgrass2022CervicalExtensors,
+ author = {Snodgrass, S. J. and Stanwell, P. and Weber, K. A. and Shepherd, S. and Kennedy, O. and Thompson, H. J. and Elliott, J. M.},
+ title = {Greater Muscle Volume and Muscle Fat Infiltrate in the Deep Cervical Spine Extensor Muscles in Individuals with Chronic Idiopathic Neck Pain Compared to Controls},
+ journal = {BMC Musculoskeletal Disorders},
+ year = {2022},
+ volume = {23},
+ number = {1},
+ pages = {973},
+ doi = {10.1186/s12891-022-05924-3}
+}
+
+@article{Franettovich2022Foot7T,
+ author = {Franettovich Smith, M. M. and Mendis, M. D. and Weber, K. A. and Elliott, J. M. and Ho, R. and Wilkes, M. J. and Collins, N. J.},
+ title = {Improving the Measurement of Intrinsic Foot Muscle Morphology and Composition from High-Field (7T) Magnetic Resonance Imaging},
+ journal = {Journal of Biomechanics},
+ year = {2022},
+ volume = {140},
+ pages = {111164},
+ doi = {10.1016/j.jbiomech.2022.111164}
+}
+
+@article{Perraton2022LateralHipROIs,
+ author = {Perraton, Z. and Lawrenson, P. and Mosler, A. B. and Elliott, J. M. and Weber, K. A. and Flack, N. A. and Cornwall, J. and Crawford, R. J. and Stewart, C. and Semciw, A. I.},
+ title = {Towards Defining Muscular Regions of Interest from Axial Magnetic Resonance Imaging with Anatomical Cross-Reference: A Scoping Review of Lateral Hip Musculature},
+ journal = {BMC Musculoskeletal Disorders},
+ year = {2022},
+ volume = {23},
+ number = {1},
+ pages = {533},
+ doi = {10.1186/s12891-022-05439-x}
+}
+
+@article{Paliwal2021DCM,
+ author = {Paliwal, M. and Weber, K. A. and Smith, A. C. and Elliott, J. M. and Muhammad, F. and Dahdaleh, N. S. and Bodurka, J. and Dhaher, Y. and Parrish, T. B. and Mackey, S. and Smith, Z. A.},
+ title = {Fatty Infiltration in Cervical Flexors and Extensors in Patients with Degenerative Cervical Myelopathy Using a Multi-Muscle Segmentation Model},
+ journal = {PLOS ONE},
+ year = {2021},
+ volume = {16},
+ number = {6},
+ pages = {e0253863},
+ doi = {10.1371/journal.pone.0253863}
+}
+
+@article{Weber2021MultiMuscleSeg,
+ author = {Weber, K. A. and Abbott, R. and Bojilov, V. and Smith, A. C. and Wasielewski, M. and Hastie, T. J. and Parrish, T. B. and Mackey, S. and Elliott, J. M.},
+ title = {Multi-Muscle Deep Learning Segmentation to Automate the Quantification of Muscle Fat Infiltration in Cervical Spine Conditions},
+ journal = {Scientific Reports},
+ year = {2021},
+ volume = {11},
+ number = {1},
+ pages = {16567},
+ doi = {10.1038/s41598-021-95972-x}
+}
+
+@article{Elliott2020WhiplashCTMRI,
+ author = {Elliott, J. M. and Smith, A. C. and Hoggarth, M. A. and Albin, S. R. and Weber, K. A. and Haager, M. and Fundaun, J. and Wasielewski, M. and Courtney, D. M. and Parrish, T. B.},
+ title = {Muscle Fat Infiltration Following Whiplash: A Computed Tomography and Magnetic Resonance Imaging Comparison},
+ journal = {PLOS ONE},
+ year = {2020},
+ volume = {15},
+ number = {6},
+ pages = {e0234061},
+ doi = {10.1371/journal.pone.0234061}
+}
+
+@article{Franettovich2020FEET,
+ author = {Franettovich Smith, M. M. and Collins, N. J. and Mellor, R. and Grimaldi, A. and Elliott, J. and Hoggarth, M. and Weber, K. A. and Vicenzino, B.},
+ title = {Foot Exercise plus Education Versus Wait and See for the Treatment of Plantar Heel Pain (FEET Trial): A Protocol for a Feasibility Study},
+ journal = {Journal of Foot and Ankle Research},
+ year = {2020},
+ volume = {13},
+ number = {1},
+ pages = {20},
+ doi = {10.1186/s13047-020-00384-1}
+}
+
+@article{Weber2019WhiplashDL,
+ author = {Weber, K. A. and Smith, A. C. and Wasielewski, M. and Eghtesad, K. and Upadhyayula, P. A. and Wintermark, M. and Hastie, T. J. and Parrish, T. B. and Mackey, S. and Elliott, J. M.},
+ title = {Deep Learning Convolutional Neural Networks for the Automatic Quantification of Muscle Fat Infiltration Following Whiplash Injury},
+ journal = {Scientific Reports},
+ year = {2019},
+ volume = {9},
+ number = {1},
+ pages = {7973},
+ doi = {10.1038/s41598-019-44416-8}
+}
+
+@article{Smith2017SpinalCordSCI,
+ author = {Smith, A. C. and Weber, K. A. and Parrish, T. B. and Hornby, T. G. and Tysseling, V. M. and McPherson, J. G. and Wasielewski, M. and Elliott, J. M.},
+ title = {Ambulatory Function in Motor Incomplete Spinal Cord Injury: A Magnetic Resonance Imaging Study of Spinal Cord Edema and Lower Extremity Muscle Morphometry},
+ journal = {Spinal Cord},
+ year = {2017},
+ volume = {55},
+ number = {7},
+ pages = {672--678},
+ doi = {10.1038/sc.2017.18}
+}
diff --git a/docs/neurodesk.md b/docs/neurodesk.md
new file mode 100644
index 0000000..b1e998c
--- /dev/null
+++ b/docs/neurodesk.md
@@ -0,0 +1,126 @@
+---
+title: Neurodesk Webapps
+parent: Key features
+description:
+grand_parent: User section
+nav_order: 5
+permalink: /neurodesk/
+---
+
+## MuscleMap Neurodesk Web Application
+
+MuscleMap is also available through a Neurodesk-powered web application that allows fully automated whole-body muscle segmentation directly from your browser. This interface is designed for researchers, clinicians, and imaging scientists who want to easily run MuscleMap without installing any software.
+
+The Neurodesk interface provides a streamlined workflow: simply upload your imaging data, run the segmentation, and visualise the results.- For more information about NeuroDesk, click [here](https://neurodesk.org/).
+
+
+
+---
+
+### Why use the MuscleMap 3D Slicer extension?
+
+- No programming required
+- Fully integrated into 3D Slicer
+- Supports CT and MRI
+- Automated whole-body muscle segmentation
+- Interactive 2D and 3D visualisation
+- Export-ready segmentation labels for quantitative analysis
+
+---
+### Installation
+
+### Step 1 – Install 3D Slicer
+
+Download and install the latest (preview release!) version of 3D Slicer from:
+https://www.slicer.org
+
+
+ Note
+ As of March 11, 2026, MuscleMap is only available in the Preview Release of 3D Slicer.
+ Once MuscleMap becomes available in the stable release, we will update both the tutorial video and the written instructions accordingly.
+
+
+---
+### Step 2 – Install the PyTorch (SlicerPyTorch) extension
+
+MuscleMap requires PyTorch to run deep-learning models inside Slicer.
+
+1. Open 3D Slicer
+2. Go to:
+ View → Extensions Manager
+3. Search for:
+ PyTorch or SlicerPyTorch
+4. Install the extension
+5. Restart 3D Slicer
+
+---
+
+### Step 3 – Install PyTorch inside Slicer
+
+After restarting Slicer:
+
+1. Go to:
+ View → Modules
+2. Navigate to:
+ Utilities → PyTorch (SlicerPyTorch)
+3. Click:
+ Install PyTorch
+4. Choose:
+ - **GPU version** (recommended if a compatible GPU is available)
+ - or **CPU version** otherwise
+
+Wait until the installation is completed successfully.
+
+---
+
+### Step 4 – Install the MuscleMap extension
+
+1. Open Extensions Manager again
+2. Search for:
+ MuscleMap
+3. Install the extension
+4. Restart 3D Slicer
+
+After restarting, the module is available under the MuscleMap category.
+
+---
+
+### Using SlicerMuscleMap
+
+### 1. Open the MuscleMap module
+Go to:
+View → Modules → MuscleMap → MuscleMap Whole-Body Segmentation
+
+---
+
+### 2. Install MuscleMap dependencies (one-time step)
+
+Inside the module:
+
+1. Open Installing packages
+2. Click:
+ Install MuscleMap dependencies
+
+This installs MONAI, nibabel, pandas, and the MuscleMap toolbox inside Slicer’s Python environment.
+
+---
+
+### 3. Load an image volume
+
+You can load data in two ways:
+
+- Click Load volume from file…
+- Or select an already loaded volume using Input volume
+
+Supported formats include:
+- `.nii`, `.nii.gz`
+
+Both **CT and MRI** are supported.
+
+---
+
+### 4. Run MuscleMap segmentation
+
+1. Select the input volume
+2. (Optional) Enable **Force CPU** under *Advanced* if needed
+3. Click:
+ Run MuscleMap segmentation
+
+The model will automatically:
+- Export the volume
+- Run `mm_segment`
+- Load the resulting segmentation
+- Apply anatomical labels and colors
+- Display the result in 2D and 3D
+
+---
+
+### 5. Visualise results in 3D
+
+After segmentation:
+- The output segmentation appears automatically
+- Click Show 3D to enable 3D rendering
+- Use standard Slicer tools for inspection, annotations or export
+
+---
+
+## Source code and development
+
+The 3D Slicer extension is open-source and actively developed.
+
+
+ View SlicerMuscleMap code
+
+
+---
+
+## Reporting issues and requesting features
+
+If you encounter an error, unexpected behaviour, or have a feature request, please open an issue on GitHub.
+
+
+ Report an issue
+
+
+Providing the following information helps us resolve issues faster:
+- 3D Slicer version
+- Operating system
+- CPU/GPU details
+- Error message or log output
+- Example data (if possible)
+
+---
+
+## Citation
+
+If you use MuscleMap for academic or scientific work, please cite the MuscleMap consortium publications listed in the module acknowledgements.
+
+---
+
+**MuscleMap** – Open-source, community-supported whole-body muscle quantification.
+
+
+ ← Back to MuscleMap overview
+
diff --git a/docs/support.md b/docs/support.md
new file mode 100644
index 0000000..879512e
--- /dev/null
+++ b/docs/support.md
@@ -0,0 +1,55 @@
+---
+title: Support Musclemap
+parent: Overview
+description: "Donate and/or support MuscleMap to make muscle segmentation models and quantification tools openly available. "
+nav_order: 5
+permalink: /support/
+---
+
+## Support the MuscleMap project
+
+Your support of MuscleMap will facilitate breakthroughs that both save and transform the lives of children and adults living with debilitating pain and disability. Though MuscleMap has significant potential to reduce the massive economic burden of musculoskeletal and neurological conditions, we have received no federal funding for this project to date. Only by providing MuscleMap with appropriate infrastructure will we be able to serve the billions of people around the world who stand to benefit directly from its application, in multiple ways.
+
+The generous support of our community is the only means by which we will succeed in bringing MuscleMap fully to life, to achieve its extraordinary potential.
+
+It will revolutionise standards of clinical care, providing the foundations for highly personalised and effective treatment plans, with better patient outcomes.
+
+And it will help push the limits of human endurance and performance in the most exciting realms of discovery—perhaps even extending the frontiers of what’s possible for human exploration and existence in deep space.
+
+
+ ♡
+ Support MuscleMap
+
+
+
+
+
+ ← Back to MuscleMap overview
+
+
diff --git a/docs/testimonial.md b/docs/testimonial.md
new file mode 100644
index 0000000..aa5233d
--- /dev/null
+++ b/docs/testimonial.md
@@ -0,0 +1,73 @@
+---
+title: People using MuscleMap
+parent: Overview
+description: "MuscleMap testimonial for muscle segmentation and quantification."
+nav_order: 3
+permalink: /testimonial/
+nav_exclude: true
+search_exclude: true
+---
+
+## Share your MuscleMap experience
+
+Do you also use *MuscleMap* and would like to share your experience with the community?
+We warmly invite you to contribute a testimonial and tell us how MuscleMap supports your research or clinical work. Add your testimonial by [clicking here](https://forms.office.com/r/DKMn18WHby).
+
+*Submitted testimonials will be featured on this page. Thank you for helping us grow and improve MuscleMap.*
+
+---
+
+
+ My research focuses on understanding how muscle morphology and quality relate to pain, function, and recovery across a range of clinical and athletic populations. MuscleMap has been an integral tool in several of my projects to date. I have used the platform to quantify changes in paraspinal and gluteal muscle morphology following exercise interventions in individuals with chronic low back pain, to investigate the relationship between paraspinal muscle strength and muscle structure, and to characterize cervical muscle morphology in athletes with and without concussion. MuscleMap has provided consistent, high-quality, and reproducible measures that have strengthened the scientific rigor of these studies. I am also planning to use the platform in an upcoming project examining leg muscle morphology in individuals with COPD. The MuscleMap consortium is collaborative, innovative, and deeply committed to advancing musculoskeletal research through cutting-edge imaging analysis methods. MuscleMap is a valuable asset to my work and catalyst for new scientific insight.
+
+
+
+
+
+
+
+
+
+ Sarah Glastras, PhD | Department of Diabetes, Endocrinology & Metabolism, Royal North Shore Hospital, Sydney, Australia; Kolling Institute, University of Sydney, Australia
+
+
+
+
+ My research explores the effects of metabolic benefits from weight loss therapies, and my research team is particularly interested in the relationship between adipose tissue (fat), muscle and cardiovascular health. The MuscleMap is being used in our current study investigating the effects of weight reduction with tirzepatide on muscle composition, and muscle function. The MuscleMap consortium is collaborative, invested in discovering new evidence, and forward thinking in using the most novel and innovative technologies.
+
+
+
+
+
+
+
+
+ Enrico De Martino, PhD | Department of Health Technology and Medicine, Aalborg University, Denmark
+
+
+
+
+ My research examines the effects of human deconditioning. In particular, I investigate lumbopelvic deconditioning and low back pain using a range of methodologies, including magnetic resonance imaging, electromyography, kinematic analysis, and functional tasks. MuscleMap is currently used in my ongoing studies investigating the effects of spaceflight and bed rest as a spaceflight analogue. The platform provides a robust and innovative framework for quantitative muscle and fat analysis, which is essential for addressing our research questions. The MuscleMap consortium is highly collaborative, strongly committed to generating new scientific evidence, and forward-thinking in its adoption of novel, cutting-edge technologies. I see MuscleMap as a valuable and evolving tool for musculoskeletal research in both clinical and spaceflight contexts.
+
+
+
+
+
+
+ ← Back to MuscleMap overview
+
\ No newline at end of file
diff --git a/docs/user-section.md b/docs/user-section.md
new file mode 100644
index 0000000..0eb76ca
--- /dev/null
+++ b/docs/user-section.md
@@ -0,0 +1,6 @@
+---
+title: User section
+nav_order: 2
+has_children: true
+permalink: /user-section/
+---
\ No newline at end of file
diff --git a/docs/why-musclemap.md b/docs/why-musclemap.md
new file mode 100644
index 0000000..9ff1a68
--- /dev/null
+++ b/docs/why-musclemap.md
@@ -0,0 +1,64 @@
+---
+title: Why Musclemap?
+parent: Overview
+description: "MuscleMap is an open-source AI platform for whole-body muscle segmentation, muscle quantification, and intramuscular fat analysis from MRI and CT."
+nav_order: 2
+permalink: /why-musclemap/
+---
+
+## AI-driven muscle segmentation and quantification for early disease detection
+
+Musculoskeletal and neurological conditions affect billions of people worldwide and are a leading cause of disability. Quantitative muscle imaging, including automated muscle segmentation and intramuscular fat quantification from MRI and CT, offers a powerful but underused opportunity to detect disease earlier.
+
+MuscleMap was created to close this gap. It is an open-source, platform for whole-body muscle segmentation, muscle quantification, and intramuscular fat analysis, enabling scalable and standardised assessment of skeletal muscle health across populations.
+
+---
+
+### Why muscle matters
+
+Skeletal muscle is far more than a system for movement. Changes in muscle size, shape, and composition often occur years before overt clinical symptoms emerge in a wide range of conditions, including:
+
+- musculoskeletal disorders
+- neurological disease
+- metabolic and systemic illness
+- ageing-related functional decline
+
+As populations grow and age, the prevalence of these conditions will rise sharply. In Australia alone, healthcare costs related to musculoskeletal and neurological conditions are projected to exceed $21 billion by 2033, representing an increase of more than 300%. Similar trends are observed globally. Early, objective, and scalable assessment of muscle health is therefore no longer optional—it is essential.
+
+---
+
+### What is MuscleMap?
+
+MuscleMap is an AI-driven imaging platform and global dataset that uses advanced deep learning models to automatically segment skeletal muscle from MRI and CT scans, anywhere in the body. From these segmentations, MuscleMap derives precision biomarkers that quantify muscle size, shape, and spatial distribution.
+
+Unlike traditional approaches that rely on manual analysis or focus on a single muscle group, MuscleMap is designed to be:
+
+- **Whole-body** – applicable to any anatomical region
+- **Automated** – removing the need for time-consuming manual work
+- **Standardised** – enabling consistent measurements across centres
+- **Scalable** – suitable for both clinical use and large population studies
+
+The long-term vision is for MuscleMap to operate as a true “push-button” system". A clinician uploads a scan, and within moments receives a comprehensive set of muscle health metrics that are directly interpretable in a clinical context.
+
+---
+
+### Precision, context, and normative ranges
+
+Muscle health is not one-size-fits-all. Age, sex, body composition, ancestry, and other demographic factors all strongly influence what constitutes “normal” muscle. MuscleMap explicitly accounts for this variability.
+
+Drawing on data from over 100,000 scans, MuscleMap enables muscle biomarkers to be interpreted relative to population-specific normative ranges. This allows clinicians and researchers to distinguish between healthy variation and clinically meaningful muscle decline—an essential step toward precision medicine.
+
+---
+
+### A global, open resource
+
+MuscleMap is open source and freely accessible. Over the past five years, it has grown into a global consortium of more than 60 collaborators, spanning institutions, countries, and imaging platforms. Contributors upload their own datasets, helping to model healthy muscle across diverse populations worldwide.
+
+By combining large-scale imaging data with transparent methods and collaborative governance, MuscleMap aims to accelerate discovery, improve clinical decision-making, and ultimately reduce the burden of debilitating disease.
+
+---
+
+
+ ← Back to MuscleMap overview
+
diff --git a/robots.txt b/robots.txt
new file mode 100644
index 0000000..4b6c93c
--- /dev/null
+++ b/robots.txt
@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://musclemap.github.io/MuscleMap/sitemap.xml
+
diff --git a/scripts.egg-info/PKG-INFO b/scripts.egg-info/PKG-INFO
deleted file mode 100644
index 3ccd702..0000000
--- a/scripts.egg-info/PKG-INFO
+++ /dev/null
@@ -1,26 +0,0 @@
-Metadata-Version: 2.4
-Name: scripts
-Version: 1.1
-Summary: A toolbox for muscle imaging.
-Home-page: https://github.com/MuscleMap/MuscleMap.git
-Author: Kenneth Weber, Eddo Wesselink, Brian Kim, Benjamin DeLeener,Richard Yin
-Requires-Python: >=3.6
-License-File: LICENSE
-Requires-Dist: monai==1.3.2
-Requires-Dist: torch==2.4.0
-Requires-Dist: numpy==1.24.4
-Requires-Dist: nibabel==5.2.1
-Requires-Dist: scikit-learn==1.3.2
-Requires-Dist: pandas==2.0.3
-Requires-Dist: scikit-image==0.21.0
-Requires-Dist: transforms3d==0.4.2
-Requires-Dist: tqdm==4.67.1
-Requires-Dist: matplotlib==3.9.4
-Requires-Dist: psutil==6.1.1
-Requires-Dist: portalocker==3.1.1
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
diff --git a/scripts.egg-info/SOURCES.txt b/scripts.egg-info/SOURCES.txt
deleted file mode 100644
index 7f4424a..0000000
--- a/scripts.egg-info/SOURCES.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-LICENSE
-README.md
-setup.py
-scripts/__init__.py
-scripts/mm_extract_metrics.py
-scripts/mm_gui.py
-scripts/mm_register_to_template.py
-scripts/mm_segment.py
-scripts/mm_util.py
-scripts.egg-info/PKG-INFO
-scripts.egg-info/SOURCES.txt
-scripts.egg-info/dependency_links.txt
-scripts.egg-info/entry_points.txt
-scripts.egg-info/requires.txt
-scripts.egg-info/top_level.txt
-scripts/models/abdomen/contrast_agnostic_abdomen_model.json
-scripts/models/abdomen/contrast_agnostic_abdomen_model.pth
-scripts/models/leg/contrast_agnostic_leg_model.json
-scripts/models/leg/contrast_agnostic_leg_model.pth
-scripts/models/pelvis/contrast_agnostic_pelvis_model.json
-scripts/models/pelvis/contrast_agnostic_pelvis_model.pth
-scripts/models/thigh/contrast_agnostic_thigh_model.json
-scripts/models/thigh/contrast_agnostic_thigh_model.pth
-scripts/models/wholebody/contrast_agnostic_wholebody_model.json
-scripts/models/wholebody/contrast_agnostic_wholebody_model.pth
-scripts/templates/abdomen/abdomen_template.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-1.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-2.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-3.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-4.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-5.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-6.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-7.nii.gz
-scripts/templates/abdomen/abdomen_template_dseg_label-8.nii.gz
\ No newline at end of file
diff --git a/scripts.egg-info/dependency_links.txt b/scripts.egg-info/dependency_links.txt
deleted file mode 100644
index 8b13789..0000000
--- a/scripts.egg-info/dependency_links.txt
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/scripts.egg-info/entry_points.txt b/scripts.egg-info/entry_points.txt
deleted file mode 100644
index be945cb..0000000
--- a/scripts.egg-info/entry_points.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-[console_scripts]
-mm_extract_metrics = scripts.mm_extract_metrics:main
-mm_gui = scripts.mm_gui:main
-mm_register_to_template = scripts.mm_register_to_template:main
-mm_segment = scripts.mm_segment:main
diff --git a/scripts.egg-info/requires.txt b/scripts.egg-info/requires.txt
deleted file mode 100644
index a3ce898..0000000
--- a/scripts.egg-info/requires.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-monai==1.3.2
-torch==2.4.0
-numpy==1.24.4
-nibabel==5.2.1
-scikit-learn==1.3.2
-pandas==2.0.3
-scikit-image==0.21.0
-transforms3d==0.4.2
-tqdm==4.67.1
-matplotlib==3.9.4
-psutil==6.1.1
-portalocker==3.1.1
diff --git a/scripts.egg-info/top_level.txt b/scripts.egg-info/top_level.txt
deleted file mode 100644
index b744996..0000000
--- a/scripts.egg-info/top_level.txt
+++ /dev/null
@@ -1 +0,0 @@
-scripts
diff --git a/scripts/mm_segment.py b/scripts/mm_segment.py
index 850236b..9813e3c 100644
--- a/scripts/mm_segment.py
+++ b/scripts/mm_segment.py
@@ -69,7 +69,7 @@ def get_parser():
optional.add_argument("-c", '--chunk_size', required=False, default = 25, type=int,
help="Number of axials slices to be processed as a single chunk. If image is larger than chunk size, then image will be processed in separate chunks to save memory and improve speed. Default is 50 slices.")
-
+
return parser
# main: sets up logging, parses command-line arguments using parser, runs model, inference, post-processing
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..dadc795
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,93 @@
+
+
+
+
+
+ https://musclemap.github.io/MuscleMap/
+ weekly
+ 1.0
+
+
+
+ https://musclemap.github.io/MuscleMap/overview/
+ monthly
+ 0.9
+
+
+
+
+ https://musclemap.github.io/MuscleMap/publications/
+ monthly
+ 0.8
+
+
+
+ https://musclemap.github.io/MuscleMap/muscle-anatomy/
+ monthly
+ 0.8
+
+
+
+
+ https://musclemap.github.io/MuscleMap/installation/
+ monthly
+ 0.9
+
+
+
+ https://musclemap.github.io/MuscleMap/key-features/
+ monthly
+ 0.9
+
+
+
+
+ https://musclemap.github.io/MuscleMap/muscle-segmentation/
+ monthly
+ 0.95
+
+
+
+ https://musclemap.github.io/MuscleMap/muscle-quantification/
+ monthly
+ 0.95
+
+
+
+ https://musclemap.github.io/MuscleMap/muscle-registration/
+ monthly
+ 0.85
+
+
+
+ https://musclemap.github.io/MuscleMap/slicer-extension/
+ monthly
+ 0.85
+
+
+
+ https://musclemap.github.io/MuscleMap/cite/
+ yearly
+ 0.7
+
+
+
+
+ https://musclemap.github.io/MuscleMap/change-log/
+ monthly
+ 0.6
+
+
+
+ https://musclemap.github.io/MuscleMap/license/
+ yearly
+ 0.4
+
+
+
+ https://musclemap.github.io/MuscleMap/feedback/
+ yearly
+ 0.5
+
+
+