Field Mapping Toolbox

版本 1.5.0.0 (65.4 KB) 作者: Simon Robinson
Methods for B0 Mapping with Multi-Channel RF Coils in MRI (Robinson and Jovicich, MRM, 2011)
4.1K 次下载
更新时间 2011/7/8

查看许可证

The main features of this B0 field mapping (FM) toolbox are described
in Robinson and Jovicich (MRM, 2011). In brief, they are
i) combination of phase information from multi-channel coils using the
Hermitian inner Product (HP) method, the Phase Match (PM) method or
the Separate Channel (SC) method.
ii) field map denoising either via the median replacement of outliers
or via the standard deviation over RF channels (SC method only).
iii) local thresholding of fieldmaps for the maximal achievable
geometric distortion correction if used to distortion-correct EPI.

The toolbox requires magnitude and phase multi-echo gradient echo
(MGE) MRI data, or a number of single-echo gradient echo (GE) MRI
scans acquired at separate echo times, in NIfTI format. FSL [3] should
be installed, as the this toolbox uses BET, for brain extraction and
PRELUDE for unwrapping. The fast unwrapping program PHUN (Stephan
Witoszynskyj et al., Medical Image Analysis, 2009) can be used as an
alternative to PRELUDE. This is freeware available on request from
stephan[döt]witoszynskyj[ät]meduniwien.ac.at, and needs to be
installed separately.

Example GE and EPI data is available on [2]. Combined with the
examples in fm_caller.m, this should make it clear how to use the
toolbox for the most common cases.

User parameters which may change from analysis to analysis (input and
output directories, number of channels) are listed in
fm_caller.m. Other options, such as the method used for combining
phase images and thresholds for BET and PRELUDE, are listed in the
main function, fm_calc_main.m, under "%%%Start of User-defined
Parameters%%%". These may be modified in that section or moved to
fm_caller.m. If the same parameter is specified in fm_caller.m and
fm_calc_main.m, that in fm_caller.m takes precidence.

Users of Siemens MRI scanners might find it useful to convert their
DICOM data to NIfTI using dicom_sort_convert_main.m [4]
,
which reformats GE and MGE data into formats usable by this Field
Mapping Toolbox (4D, 5D and 6D NIfTI), as well as providing
acquisition parameter information in a file (text_header.txt) which
can be used by this toolbox, reducing the amount of information that
needs to be entered by the user. Alternatively, users may need to
prepare their data in a suitable format using MATLAB's "dicomread" or
the function "load_nii", then create a NIfTI structure similar to that
in case2 (one of the examples in fm_caller.m) with "make_nii" and save
this with "save_nii", all of which are part of the NIfTI toolbox for
MATLAB (Jimmy Shen, FEX ID 8797).

I've done my best to test this for NIfTI data with different
organisations of echoes, phase and magnitude and for sequence
parameters available through a text_header.txt or passed directly, but
inevitably some problems will crop up as this gets tested with a wider
variety of data from different scanners. Please get in touch at
simon[döt]robinson[ät]meduniwien.ac.at if you have problems and I'll
do my best to fix any bugs and add flexibility where that makes sense.

If you used this toolbox in your research, please cite the related
paper [1].

[1]
http://www.ncbi.nlm.nih.gov/pubmed/21608027
or
http://onlinelibrary.wiley.com/doi/10.1002/mrm.22879/pdf
[2]
http://dl.dropbox.com/u/9241799/field_mapping/fm_example_data.tar.gz

[3]
http://www.fmrib.ox.ac.uk/fsl/

[4]
http://www.mathworks.com/matlabcentral/fileexchange/22508-siemens-dicom-sort-and-convert-to-nifti

引用格式

Simon Robinson (2024). Field Mapping Toolbox (https://www.mathworks.com/matlabcentral/fileexchange/30853-field-mapping-toolbox), MATLAB Central File Exchange. 检索来源 .

MATLAB 版本兼容性
创建方式 R2009a
兼容任何版本
平台兼容性
Windows macOS Linux
类别
Help CenterMATLAB Answers 中查找有关 MRI 的更多信息

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
版本 已发布 发行说明
1.5.0.0

v1.7:
- directory definition for separate channel separate echo data
(file_code='SCSE') fixed for finding out TEs.

1.3.0.0

v1.6:
- directory definition for separate channel separate echo data
(file_code='SCSE') fixed

1.2.0.0

v1.5:
- fixed unzipping of .nii.gz data for users with FSLOUTPUTTYPE=NIFTI_GZ in fsl.sh
- replaced parfors by fors
- added link to test data (see above) and example usage for the test data

1.1.0.0

v1.4: added fm_caller.m which passes parameters to the main function, fm_calc_main.m. fm_caller.m contains example calls for test data (see Description).
Generates the FUGUE command-line

1.0.0.0