mne.bem.convert_flash_mris#
- mne.bem.convert_flash_mris(subject, flash30=True, unwarp=False, subjects_dir=None, flash5=True, verbose=None)[source]#
Synthesize the flash 5 files for use with make_flash_bem.
This function aims to produce a synthesized flash 5 MRI from multiecho flash (MEF) MRI data. This function can use MEF data with 5 or 30 flip angles. If flash5 (and flash30) images are not explicitly provided, it will assume that the different echos are available in the mri/flash folder of the subject with the following naming convention “mef<angle>_<echo>.mgz”, e.g. “mef05_001.mgz” or “mef30_001.mgz”.
- Parameters:
- subject
str
Subject name.
- flash30
bool
|list
ofSpatialImage
or path-like |SpatialImage
| path-like If False do not use 30-degree flip angle data. The list of flash 5 echos to use. If True it will look for files named mef30_*.mgz in the subject’s mri/flash directory and if not False the list of flash 5 echos images will be written to the mri/flash folder with convention mef05_<echo>.mgz. If a SpatialImage object each frame of the image will be interpreted as an echo.
- unwarp
bool
Run grad_unwarp with -unwarp option on each of the converted data sets. It requires FreeSurfer’s MATLAB toolbox to be properly installed.
- subjects_dirpath-like |
None
The path to the directory containing the FreeSurfer subjects reconstructions. If
None
, defaults to theSUBJECTS_DIR
environment variable.- flash5
list
ofSpatialImage
or path-like |SpatialImage
| path-like |True
The list of flash 5 echos to use. If True it will look for files named mef05_*.mgz in the subject’s mri/flash directory and if not None the list of flash 5 echos images will be written to the mri/flash folder with convention mef05_<echo>.mgz. If a SpatialImage object each frame of the image will be interpreted as an echo.
- verbose
bool
|str
|int
|None
Control verbosity of the logging output. If
None
, use the default verbosity level. See the logging documentation andmne.verbose()
for details. Should only be passed as a keyword argument.
- subject
- Returns:
- flash5_imgpath-like
The path the synthesized flash 5 MRI.
Notes
This function assumes that the Freesurfer segmentation of the subject has been completed. In particular, the T1.mgz and brain.mgz MRI volumes should be, as usual, in the subject’s mri directory.