Skip to content

Commit 90d8378

Browse files
committed
Clarified documentation
1 parent d81998a commit 90d8378

File tree

2 files changed

+14
-88
lines changed

2 files changed

+14
-88
lines changed

README.md

Lines changed: 14 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,20 @@ At the end of the processing, you can review:
4141
|9584 |17.143453301063012|21.092693041826486|1.1247654335215769|
4242
|9418 |19.558182966645223|19.61176661536486 |1.1093208813636863|
4343

44+
## Description of the analysis
4445

45-
## Description of the scripts
46+
Two NIfTI files are required: an initial scan and a re-scan without repositioning. The analysis script `process_data.sh`
47+
includes the following steps:
48+
49+
- Check if a mask for the spinal cord and/or gray matter already exists. If not, segment them automatically.
50+
- Register the second scan to the first one. Use nearest-neighbour interpolation to preserve noise properties.
51+
- Compute white matter mask by subtracting the spinal cord and the gray matter masks.
52+
- Compute `SNR_diff` using the two-image subtraction method (Dietrich et al. J Magn Reson Imaging, 2007).
53+
- Compute `SNR_mult` using the first scan (Griffanti et al., Biomed Sign Proc and Control, 2012).
54+
- Compute `Contrast` by dividing the mean signal in the GM by that in the WM, on a slice-by-slice basis and then
55+
average across slices.
56+
57+
## Simulations
4658

4759
* [simu_create_phantom.py](./simu_create_phantom.py): Generate synthetic phantom
4860
of WM and GM that can be used to validate the proposed evaluation metrics. The phantoms are generated with random noise,
@@ -55,30 +67,7 @@ This script is particularly useful for processing the large amount of files
5567
generated by the phantom construction.
5668
* [simu_make_figures.py](./simu_make_figures.py): Make figures to assess
5769
metrics sensitivity to image quality. Run after simu_process_data.py
58-
* [make_figures_compare_SNR.py](./make_figures_compare_SNR.py): Make figures to assess
59-
the correlation between SNR_single and SNR_diff.
60-
61-
## Analysis
62-
63-
Two NIfTI files are required: an initial scan and a re-scan without repositioning.
64-
65-
### Pre-processing
66-
- The second image is registered to the first in order to compute the SNR using the two-image subtraction method.
67-
- The spinal cord and gray matter of each image are segmented automatically.
68-
- White matter segmentation is generated by subtracting the gray matter segmentation from the cord segmentation.
69-
70-
### Signal-to-noise ratio (SNR):
71-
The SNR is determined with two different methods: SNR_diff and SNR_single.
72-
- SNR_diff is computed with SCT using the two-image subtraction method (Dietrich et al. J Magn Reson Imaging, 2007).
73-
- SNR_single is computed from a single image (Griffanti et al., Biomed Sign Proc and Control, 2012).
74-
75-
### Contrast:
76-
The mean signal is computed in the white matter and gray matter of image 1. The contrast is then computed according to the following equation:
77-
78-
~~~
79-
Contrast = abs(mean(WM) - mean(GM)) / min{mean(WM),mean(GM)}
80-
~~~
81-
70+
8271
## Configuration of Niftyweb server
8372
- make sure the script WMGM is declared in `PATH`
8473
- add an entry to the crontab that points to the Daemon. Example (to edit, use `crontab -e`):

make_figures_compare_SNR.py

Lines changed: 0 additions & 63 deletions
This file was deleted.

0 commit comments

Comments
 (0)