Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/bayer-group/freggan

https://github.com/bayer-group/freggan

Science Score: 10.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ○
    codemeta.json file
  • ○
    .zenodo.json file
  • ○
    DOI references
  • ✓
    Academic publication links
    Links to: arxiv.org, zenodo.org
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (11.9%) to scientific vocabulary

Keywords

beat-undefined
Last synced: 9 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: Bayer-Group
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: main
  • Size: 1.48 MB
Statistics
  • Stars: 4
  • Watchers: 3
  • Forks: 0
  • Open Issues: 8
  • Releases: 0
Topics
beat-undefined
Created over 2 years ago · Last pushed over 2 years ago
Metadata Files
Readme Contributing License Codeowners

README.md

fRegGAN: K-space Loss Regularization for Medical Image Translation

python pytorch lightning hydra black pre-commit

Paper

Welcome to the official code repository for the paper "fRegGAN: K-space Loss Regularization for Medical Image Translation". The repository is dedicated to enabling researchers and developers to reproduce the results presented in our paper.

The code present in this repository is maintained by the original authors of the paper and is open to contributions, fixes, and updates from the research community.

Please note, while the preprocessed data is available, the trained models are not part of this repository. The objective of this repository is to facilitate an understanding of our methodology and to allow the research community to reproduce and validate our results.

We sincerely hope that our work contributes to your research, development, and understanding of frequency-regularized generative adversarial networks. Happy coding!

image

BibTeX

bibtex @article{baltruschat2023freggan, title={fRegGAN with K-space Loss Regularization for Medical Image Translation}, author={Ivo M. Baltruschat and Felix Kreis and Alexander Hoelscher and Melanie Dohmen and Matthias Lenga}, year={2023}, eprint={2303.15938}, archivePrefix={arXiv}, primaryClass={eess.IV} }

Getting Started

Software dependencies

  • Conda as environment manager. If not installed, you can download and install Mamba with the following command:\ curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-$(uname)-$(uname -m).sh" && bash Mambaforge-$(uname)-$(uname -m).sh

  • Poetry as dependency and package manager. If not installed, you can download and install the preview version with:\ curl -sSL https://install.python-poetry.org | python3 - --version 1.2.2

  • WandB as experiment tracking, data versioning. Using wandb requires you to setup an account first. After that just complete the config as below.

Installation process

First we need to create a conda environment and install all needed packages. This can be done manually or automatically.\

bash conda env create -p "$PWD/.envs/cmrai_py39" --file "$PWD/docker-pytorch/environment.yml" conda activate "$PWD/.envs/cmrai_py39" poetry install --no-dev export WANDB_USER=[YOUR_username] export WANDB_KEY=[API_KEY] export WANDB_ENTITY=[YOUR_ENTITY] dump-env --source=.env.template > .env

Data preparation

We uploaded a preprocessed version of the BraTS2021 dataset to Zenodo here. First, you need to download the data and then unzip the tar.gz file into the folder data.

bash zenodo_get 8141526 tar -xzvf brats2021_nii.tar.gz -C "$PWD/data"

Then run the following commands to prepare the data.

bash python cmrai/data/prepare_brats.py python cmrai/data/process_brats.py --data_dim=2d python cmrai/data/splitdata_brats.py --data_dim=2d --do_cleaning


🚀 Quickstart

bash python cmrai/train.py experiment=paper_01_cycle_gan_00.yaml

Resources

This project was inspired by:

Useful repositories:

Other resources:

Owner

  • Name: Bayer Open Source
  • Login: Bayer-Group
  • Kind: organization

Science for a better life

GitHub Events

Total
  • Member event: 1
Last Year
  • Member event: 1

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 1
  • Total Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Ivo Baltruschat i****t@b****m 1
Committer Domains (Top 20 + Academic)
bayer.com: 1

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 0
  • Total pull requests: 20
  • Average time to close issues: N/A
  • Average time to close pull requests: 5 days
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.6
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 20
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
Pull Request Authors
  • dependabot[bot] (23)
Top Labels
Issue Labels
Pull Request Labels
dependencies (23)

Dependencies

docker-pytorch/Dockerfile docker
  • nvidia/cuda 11.7.0-devel-ubuntu20.04 build
docker-pytorch/environment.yml pypi
poetry.lock pypi
  • 270 dependencies
pyproject.toml pypi