README.md

Surface Coil Intensity Correction (SCC)

1. Create a new environment named SCC in Conda and activate it with the following command (Don't close the terminal, we will use it in step 3):
   • Open a new terminal and run the following command:

   conda create --name SCC python jupyterlab ipykernel -y && conda activate SCC && python -m ipykernel install --user --name=SCC --display-name "SCC"
   

Important

If you have compatibility issues, try the following command to create your Conda environment instead:

conda create --name SCC python=3.8 jupyterlab ipykernel -y && conda activate SCC && python -m ipykernel install --user --name=SCC --display-name "SCC"

2. Clone the GitHub repository to your local workstation

3. Open brightness_correction_demo.ipynb in Anaconda, VS Code, etc.

   In the terminal you opened in step 1, do the following steps:

   • Navigate to the folder you just downloaded using: cd path_to_the_folder_you_just_downloaded
   • Run jupyter lab in the terminal
   • Execute all cells in brightness_correction_demo.ipynb for a quick verification. If you can see the demo output, it means you have successfully installed and configured SCC.

Important

Ensure the SCC environment is selected before executing the cells!

For installing the package content (optional)

Navigate to the path of the SCC folder and run the following command:

pip install -e

Representative results

Figure 1: From left to right, correction map for the image, correction map for the sensitivity maps, magnitude of the uncorrected image, magnitude of the image corrected with the first correction map, the magnitude of the image where the sensitivity maps are corrected with the second correction map. A representative two-chamber view of the heart is shown.
Figure 2: From left to right, correction map for the image, correction map for the sensitivity maps, magnitude of the uncorrected image, magnitude of the image corrected with the first correction map, the magnitude of the image where the sensitivity maps are corrected with the second correction map. A representative long axis view of the heart is shown.

Pulication

eprint arXiv:2312.00936