pyMEAL 1.0.1

pyMEAL: Multi-Encoder-Augmentation-Aware-Learning

pyMEAL: Multi-Encoder-Augmentation-Aware-Learning

pyMEAL is a multi-encoder framework for augmentation-aware learning that accurately performs CT-to-T1-weighted MRI translation under diverse augmentations. It utilizes four dedicated encoders and three fusion strategies, concatenation (CC), fusion layer (FL), and controller block (BD), to capture augmentation-specific features. MEAL-BD outperforms conventional augmentation methods, achieving SSIM > 0.83 and PSNR > 25 dB in CT-to-T1w translation.

Model Architecture Overview

Fig. 1:Model architecture for the model having no augmentation and traditional augmentation

Fig. 2: Model architecture for Multi-Stream with a Builder Controller block method (BD), Fusion layer (FL) and Encoder concatenation (CC)

Dependecies

tensorflow

matplotlib

SimpleITK

scipy

antspyx

Available Models

Model ID	File Name	Description
BD	builder1_mode1l1abW512_1_11211z1p1rt_.h5	Builder-based architecture model
CC	best_moderRl_RHID2_1mo.h5	Encoder-concatenation-based configuration
FL	bestac22_mode3l_512m2_m21.h5	Feature-level fusion-based model
NA	direct7_11ag23f11.h5	Direct training baseline model
TA	best_modelaf2ndab7_221ag12g11.h5	traditional augmentation configuration model

Download Model Files

You can download any .h5 file directly:

• Download builder1_mode1l1abW512_1_11211z1p1rt_.h5
• Download best_moderRl_RHID2_1mo.h5
• Download bestac22_mode3l_512m2_m21.h5
• Download direct7_11ag23f11.h5
• Download best_modelaf2ndab7_221ag12g11.h5

or alternatively, you can use the following Python script to downlaod all the models from Huggingface.

from huggingface_hub import hf_hub_download
import tensorflow as tf

my_folder = "./my_models"  # or any path you want

model_path = hf_hub_download(
    repo_id="AI-vBRAIN/pyMEAL",
    filename="builder1_mode1l1abW512_1_11211z1p1rt_.h5",  # or any other desired model in our Huggingface.
    repo_type="model",
    cache_dir=my_folder
)

# Load the model from that path
model = tf.keras.models.load_model(model_path, compile=False)
# Run inference
output = model.predict(input_data)

Here, input_data refers to a CT image, and the corresponding T1-weighted (T1w) image is predicted as the output.

For detailed instructions on how to use each module of the pyMEAL software, please refer to the tutorial section on our GitHub repository.

Finally, create and activate a virtual environment, then install pyMEAL.

conda create -n pyMEAL python=3.9
conda activate pyMEAL
pip install pyMEAL

How to get support?

For help, contact:

Dr. Ilyas ([e-mail]) or Dr. Maradesa ([e-mail])