v2.2.5

📦 Release: v2.2.5 – Fix issues downloading data & FreeSurfer Pial Surface reconstruction

Release date: February 20, 2026

This release fixes issues in data downloading, FreeSurfer pial surface reconstruction, and BIDS format flexibility. This version is for CPU users only.

This version is for CPU uses only. A compatible GPU version is provided as v2.2.5_gpu.

---

Updates & Fixes

• 📥 Change in Data Downloading

The meld data are now download from GIthub, as Figshare the platform hosting the MELD Graph model parameters results in failures during the automated downloading of the parameters. This fixes issue #102

• 🧠 FreeSurfer Pial Surface Fix

Added Global Expert options file in $SUBJECT_DIR to fix a small known bug when reconstructing the pial surface using FLAIR images. This fix follow the recommendations provided by FreeSurfer. No major changes.

-📊 Report Enhancements

Save hemisphere information in CSV format during MELD patient report creation

• 🗂️ BIDS Layout Fix

Improved flexibility of the BIDS configuration file, resolving previous issues with bidslayout

🧹 Minor code cleanup for stability and maintainability

---

Instructions to use MELD Graph v2.2.5

REGISTER TO GET YOUR MELD LICENSE: we request that all MELD graph users fill the MELD Graph registration form. Following registration you will received a license file. This file will be needed for use of all future MELD Graph versions v2.2.4 and above. Your email address will be added to the MELD Graph mailing list. This will ensure that we can update you about bugs fix and new releases.

New users ➡️ please follow the instructions on the README

Existing users ➡️ please follow the guidelines Updating MELD Graph version in our FAQ to update your code

meld_graph_data

📦 Release: data folder needed to run MELD Graph

Release date: February 20, 2026

🔧 This release offers an alternative way to download the MELD data, as Figshare the platform hosting the MELD Graph model parameters, results in failures during the automated downloading of the parameters. This fixes issue #102

---

Notes on the folders

• input: contains the input scans for each subject you want to run with MELD Graph
• meld_params: contains the parameters needed by MELD Graph for the preprocessing of the data
• models: contains the weights of the MELD Graph model
• output: contains the outputs from the FreeSurfer segmentation (fs_outputs), the output of the preprocessing of surface-based features (preprocessed_surf_data), the outputs of the prediction in surface-based (classifier_outputs), the final nifti prediction in native space and interpretable report produced by the MELD Graph tool (predictions_reports)

Notes on the test data

DO NOT run MELD Graph on sub-test001
The input folder contain test data to run "pytest", the command that test if MELD Graph is correctly installed. The test subject provided sub-test001 is given as an example of how to organised your data. The nifti files contained in this folder are empty. Therefore if you run MELD Graph on this subject, it will fail.

More information

For more information on how to prepare your data to run MELD Graph, look at the "Prepare the data" guidelines

For more information on how to run MELD Graph, look at "Predict FCD-lesion on MRI data" guidelines

For more information on how to interprete the output of MELD Graph, look at "Interpretation of the MELD Graph pipeline results" guidelines

v2.2.4_gpu

📦 Release: v2.2.4_gpu – GPU version of v2.2.4

Release date: December 08, 2025

This release increases the level of security to use the MELD Graph package by introducing a mandatory registration and license and clarifying the intended uses in the MELD report.
No breaking changes have been introduced.

This version is for GPU uses only. A compatible CPU version is provided as v2.2.4.

Please refer to v2.2.4 release for more information

v2.2.4

📦 Release: v2.2.4 – Documentation & License Security Update

Release date: Novembre 20, 2025

This release increases the level of security to use the MELD Graph package by introducing a mandatory registration and license and clarifying the intended uses in the MELD report.
No breaking changes have been introduced.

This version is for CPU uses only. A compatible GPU version is provided as v2.2.4_gpu.

All current users are required to update to v2.2.4 and above. Older versions will be deprecated and not supported

---

📝 New Features

• 📄 First-page documentation in MELD Patient Report
  A dedicated first page has been added to the MELD patient report clarifying the intended use and summarising the tools performances and what can be expected by the tool.

• 🔐 License & Registration Requirement
  A new security layer has been implemented: MELD Graph now requires a license file to run. Users must register with the MELD team to receive their license. This change helps us maintain responsible distribution, ensure compliance, and support communication about bug fix and new release.

• 🐳 Docker Changes
  Two docker images are now available for separate CPU (meldproject/meld_graph:v2.2.4) and GPU (meldproject/meld_graph:v2.2.4_gpu) use.

• 🧹 Minor code cleanup for improved stability and maintainability

---

Instructions to use MELD Graph v2.2.4

REGISTER TO GET YOUR MELD LICENSE: we request that all MELD graph users fill the MELD Graph registration form. Following registration you will received a license file. This file will be needed for use of all future MELD Graph versions v2.2.4 and above. Your email address will be added to the MELD Graph mailing list. This will ensure that we can update you about bugs fix and new releases.

New users ➡️ please follow the instructions on the README

Existing users ➡️ please follow the guidelines Updating MELD Graph version in our FAQ to update your code

v2.2.3

📦 Release: v2.2.3 – GPU Support in Docker

Release date: October, 2025

This bug fix release resolves GPU compatibility issues in v2.2.1 and v2.2.2 and improves overall stability within the Docker environment.
No breaking changes have been introduced.

---

🔧 Bug Fixes

• ✅ GPU functionality restored in Docker
  Fixed issues preventing GPU usage within the Docker image. (fixes #92)

  Still fully compatible with older files.

• 📚 Updated recommendations for FLAIR scan usage
  Based on user feedback regarding variability in MELD Graph results when using T1w + FLAIR scans versus T1w-only scans, we now recommend:
  -- Primarily relying on T1w scans for lesion detection.
  -- Using FLAIR scans optionally to enhance sensitivity, while interpreting additional clusters with caution due to possible false positives.
  For detailed guidance on running a second analysis with FLAIR, see our FAQs

• 🧹 Minor code cleanup
  Improved code structure and maintainability (fixes #93).

---

Instructions to use MELD Graph v2.2.3

SIGN UP TO THE MELD GRAPH MAILING LIST: we request that all MELD graph users sign up the MELD Graph mailing list. Please send an email to meld.study@gmail.com with the subject "Request to be added to the MELD Graph mailing list" and provide us with your name and institute. This will ensure that we can update you about bug fixes and new releases.

To use the MELD Graph v2.2.3 docker you will to follow the docker installation guidelines and also change the compose.yml file docker from meldproject/meld_graph:latest to meldproject/meld_graph:v2.2.3

This version is still in test. Please report any issues that you might have to meld.study@gmail.com

v2.2.2

📦 Release: v2.2.2 – Bug Fixes & Compatibility Improvements

Release date: April 29, 2025

This is a bug fix release that addresses issues found in v2.2.1 and improves compatibility and usability. No breaking changes have been introduced.

---

🔧 Bug Fixes

• ✅ Right Hemisphere Prediction Alignment
  Fixed an issue in the backward registration process (from fsaverage_sym surface to native T1 volume) that caused a slight spatial shift (~a few millimeters) in lesion predictions on the right hemisphere.

  ❌ Not compatible with old test data used for pytest. Please see instructions below to download the new test data.

• 🧠 Harmonisation Input Handling
  Removed the requirement to specify scanner strength in demographics_file.csv for harmonisation. This resolves errors when scanner strength wasn’t 3T (fixes #75)

  ✅ Still fully compatible with older files that include scanner strength and old harmonisation files.

• 🧾 T1 Merge Script Compatibility
  Fixed the standalone script for merging predictions with the T1 volume, which previously failed when handling predictions with different values for salient vs. non-salient vertices.

• 📚 Updated documentation based on users feedback
  Instructions for use of Docker Desktop ; Instructions to join the mailing list; Clarification on FAQ (answers #73 #76)

• 🧹 Minor code cleanup for improved stability and maintainability (fixes #34)

---

Instructions to use MELD Graph v2.2.2

SIGN UP TO THE MELD GRAPH MAILING LIST: we request that all MELD graph users sign up the MELD Graph mailing list. Please send an email to meld.study@gmail.com with the subject "Request to be added to the MELD Graph mailing list" and provide us with your name and institute. This will ensure that we can update you about bug fixes and new releases.

New users ➡️ please follow the instructions on the README

Existing users ➡️ please follow the guidelines Updating MELD Graph to V2.2.2 in our FAQ, to update your code, download the new test set and fix the registration of your predictions

v2.2.1

Fix bug:

• fix path to download data

V2.2.0

Latest up to date release - undergoing testing

What's Changed

• Final fixes by @mathrip

2.2.0

Bump version to 2.2.0

v2.1

Merge pull request #29 from MELDProject/dev_docker

fix documentations and add singularity installation