Published November 28, 2023 | Version v4
Software Open

MEDIGAN MODEL UPLOAD: 00007_INPAINT_BRAIN_MRI

  • 1. Korea Advanced Institute of Science and Technology (KAIST)
  • 2. University of Barcelona

Description

Model ID:

00007_INPAINT_BRAIN_MRI.

 

Uploaded via:

API

 

Tags:

['Brain', 'Tumor', 'MRI Generation', 'Inpainting', 'Brain MRI Synthesis', 'Concentric Circle', 'Tumor Inpainting', 'Tumor Grade', 'Tumor Grading', 'Cross-Modality', 'Multi-modal synthesis']

 

Usage:

This GAN is used as part of the medigan library. This GANs metadata is therefore stored in and retrieved from medigan's config filemedigan is an open-source Python library on Github that allows developers and researchers to easily add synthetic imaging data into their model training pipelines. medigan is documented here and can be used via pip install:

pip install medigan

To run this model in medigan, use the following commands.

  from medigan import Generators  
  generators = Generators() 
  generators.generate(model_id='00007_INPAINT_BRAIN_MRI',num_samples=10)

 

Description from model config:

: {"title": "Tumor Inpainting Model for Generation of Flair, T1, T1c, T2 Brain MRI Images (Trained on BRATS)", "provided_date": "August 2022", "trained_date": "2020", "provided_after_epoch": null, "version": null, "publication": "Medical Physics Journal", "doi": ["https://doi.org/10.48550/arXiv.2003.07526", "https://doi.org/10.1002/mp.14701"], "inputs": ["image_size: default=256, help=the size if height and width of the generated images.", "num_inpaints_per_sample: default=10, help=the number of tumor inpaint images per MRI modality that is generated from the same input sample", "randomize_input_image_order: default=True, help=input image order is randomized. This helps to not exclude input images if batch generation is used.", "F_img_path: default=None, help=The path to the folder were the input Flair MRI images are stored.", "T1_img_path: default=None, help=The path to the folder were the input T1 MRI images are stored.", "T1c_img_path: default=None, help=The path to the folder were the input T1c MRI images are stored.", "T2_img_path: default=None, help=The path to the folder were the input T2 MRI images are stored.", "add_variations_to_mask: default=True, help=This slightly varies the values of x_center, y_center, radius_1, radius_2, radius_3. If True, the same segmentation masks is still used to generate each of the 4 modality images. This is recommended as it results in higher image diversity.", "x_center: default=130, help=the x coordinate of the concentric circle upon which the binary mask, the tumor grade mask, and, ultimately, the generated images are based.", "y_center: default=130, help=the y coordinate of the concentric circle upon which the binary mask, the tumor grade mask, and, ultimately, the generated images are based.", "radius_1: default=10, help=the radius of the first (inside second) of three concentric circles (necrotic and non-enhancing tumor) upon which the binary mask, the tumor grade mask, and, ultimately, the generated images are based.", "radius_2: default=15, help=the radius of the second (inside third) of three concentric circles (enhancing tumor) upon which the binary mask, the tumor grade mask, and, ultimately, the generated images are based.", "radius_3: default=30, help=the radius of the third of three concentric circles (edema) upon which the binary mask, the tumor grade mask, and, ultimately, the generated images are based."], "comment": "A Generative adversarial network (GAN) for Inpainting tumors (based on concentric circle-based tumor grade masks) into multi-modal MRI images (Flair, T1, T1c, T2) with dimensions 256x256. Model was trained on BRATS MRI Dataset (Menze et al). For more information, see publication (https://doi.org/10.1002/mp.14701). Model comes with example input image folders. Apart from that, the uploaded ZIP file contains the model checkpoint files .pth (model weight), __init__.py (image generation method and utils), a requirements.txt, the MEDIGAN metadata.json. The proposed method synthesizes brain tumor images from normal brain images and concentric circles that are simplified tumor masks. The tumor masks are defined by complex features, such as grade, appearance, size, and location. Thus, these features of the tumor masks are condensed and simplified to concentric circles. In the proposed method, the user-defined concentric circles are converted to various tumor masks through deep neural networks. The normal brain images are masked by the tumor mask, and the masked region is inpainted with the tumor images synthesized by the deep neural networks. Also see original repository at: https://github.com/KSH0660/BrainTumor"}

 

Files

00007_INPAINT_BRAIN_MRI.zip

Files (70.8 MB)

Name Size Download all
md5:5e22997a93bd9ef9bebd05a693375025
70.8 MB Preview Download