Skip to content
This repository was archived by the owner on Oct 14, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 27 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
# SNRAware

This repository contains the Pytorch code in our paper [SNRAware: Improved Deep Learning MRI Denoising with Signal-to-noise Ratio Unit Training and G-factor Map Augmentation](https://pubs.rsna.org/doi/full/10.1148/ryai.250227) published at the Radiology: Artificial Intelligence:
This repository contains the Pytorch code two of our papers:

[SNRAware: Improved Deep Learning MRI Denoising with Signal-to-noise Ratio Unit Training and G-factor Map Augmentation](https://pubs.rsna.org/doi/full/10.1148/ryai.250227) published at the Radiology: Artificial Intelligence

[Imaging Transformer for MRI Denoising: a Scalable Model Architecture that enables Low SNR Imaging across Applications]().

```latex
@article{
Expand All @@ -18,6 +22,19 @@ This repository contains the Pytorch code in our paper [SNRAware: Improved Deep
}
```

[Imaging Transformer for MRI Denoising: a Scalable Model Architecture that enables Low SNR Imaging across Applications]:
```latex
@misc{xue2024imagingtransformermridenoising,
title={Imaging transformer for MRI denoising with the SNR unit training: enabling generalization across field-strengths, imaging contrasts, and anatomy},
author={Hui Xue and Sarah Hooper and Azaan Rehman and Iain Pierce and Thomas Treibel and Rhodri Davies and W Patricia Bandettini and Rajiv Ramasawmy and Ahsan Javed and Zheren Zhu and Yang Yang and James Moon and Adrienne Campbell and Peter Kellman},
year={2024},
eprint={2404.02382},
archivePrefix={arXiv},
primaryClass={eess.IV},
url={https://arxiv.org/abs/2404.02382},
}
```

- Model type: Imaging AI, non-generative
- License: MIT

Expand Down Expand Up @@ -76,17 +93,22 @@ To test the model,
```bash
# download the model from the huggingface
# small model
wget https://huggingface.co/microsoft/SNRAware/resolve/main/small/snraware_small_model.pts
wget https://huggingface.co/microsoft/SNRAware/resolve/main/small/snraware_small_model.yaml
wget --directory-prefix=./small/ https://huggingface.co/microsoft/SNRAware/resolve/main/small/snraware_small_model.pts
wget --directory-prefix=./small/ https://huggingface.co/microsoft/SNRAware/resolve/main/small/snraware_small_model.yaml

# or install the huggingface cli
curl -LsSf https://hf.co/cli/install.sh | bash
# download model
hf download Microsoft/SNRAware --local-dir .

# a test data is provided at ./test/data/inference
# input data are [H, W, Frame] 3D complex tensor, input_real.npy and input_imag.npy store the
# real and imaginary part
# gmap.npy is the g-factor map for all frames or for every frame, [H, W, 1 or Frame]

# let's use the small model to run a inference
export model_file=snraware_small_model.pts
export config_file=snraware_small_model.yaml
export model_file=./small/snraware_small_model.pts
export config_file=./small/snraware_small_model.yaml

# run the inference
uv run python3 ./src/snraware/projects/mri/denoising/run_inference.py --input_dir ./test/data/phantom --output_dir /tmp/phantom_res_inference --saved_model_path $model_file --saved_config_path $config_file --batch_size 1 --input_fname input --gmap_fname gmap
Expand Down
12 changes: 6 additions & 6 deletions uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading