=Getting Started
== How to prepare your data
=== {icon folder-open} Folder structure
The most easiest way to properly load your CEST data is to sort your CEST data in one individual folder per measurement (i.e. all 2D/3D images for one Z-spectrum in one folder).
=== {icon info-circle} CEST specific meta information
There are some information needed to interpret CEST data correctly that is normaly not provided by the DICOM tags. The following section explains how to provide this information in order to load the data correctly
==== LIST.txt - Frequency offsets Δω
Put one file named `LIST.txt` in each CEST folder containing a list of the acquired frequency offsets (i.e. line by line) for this CEST image.
Example:
−300
6
5
4
// [and so on till the last offset]//
-6
NOTE: To specify the reference M0 images used for normalization off follwowing offsets, please type into the list a frequency offset Δω ≤ −300 ppm. You may have multiple M0 images in one list.
==== CEST_META.json - Additional meta information
You can either specify additional information in the loading process (see below) or store it in file `CEST_META.json` to automatically load it with the images.
To use this meta file feature, you have to put one file named `CEST_META.json` per measurement in each folder containing information about the saturation parameters. Currently the following parameters are supported:
- CEST.B1Amplitude: The RF B1amplitude
- CEST.DutyCycle: duty cycle DC in [%]
- CEST.PulseDuration: pulse duration tp in [μs]
Example:
lang=json
{
"CEST.B1Amplitude": 0.7,
"CEST.DutyCycle" : 0.8,
"CEST.PulseDuration" : 20000
}
Instead the parameters can also be specified manually via the pop-up window during data loading File reading options/CEST DICOM Manual Reader. Note: The option Merge all series allows combining images acquired in different measurements but located in the same folder.