seed
¶
seed
performs seed-based correlation analyses given a seed region or set of seed regions. For
each seed region, which may be provided either as a 3D volume (mask) in NIfTI format or coordinates.
seed
computes the pairwise connectivity between each voxel and the seed region,
for instance using the Pearson correlation coefficient between timeseries (Biswal et al., 1995).
seed_points,seed_names and seed_radius
¶
seed_names
is three-letters to identify a seed for naming purpose and can be more than one.If this field is left blank, then no seed-based correlation analysis will be performed. The
seed_points
are three coordnates (in mm) of the seed point in template space.seed_points
andseed_names
can be specify as shown below:# for one seed point correlation
seed_names[cxt]=PCC # for seed at PCC seed_points[cxt]=0,-62,24 # seed location of PCC seed_radius[cxt]=8 # 8mm radius, 5mm will de used as if radius is not specify
# for more than one seed loaction seed_names[cxt]=PCC#VMF#LOC # PCC, VMF and LOC seed_points[cxt]=0,-62,24#0,34,-14#-36,-52,-2 # seed locations
seed_mask
¶
A 3D mask can also be supply the mask must be derived from the template. xcpEngine assumes that the mask in the same dimesnion as template:
seed_names[cxt]=PCC
seed_mask[cxt]=/path/to/mask
seed_sptf
and seed_smo
¶
Spatial smoothing parameters.
Endemic noise, for instance due to physiological signals or scanner activity, can introduce
spurious or artefactual results in single voxels. The effects of noise-related artefacts can be
mitigated by spatially filtering the data, thus dramatically increasing the signal-to-noise ratio.
However, spatial smoothing is not without its costs: it effectively reduces volumetric resolution
by blurring signals from adjacent voxels. The spatial smoothing implemented in the seed
module
(i) keeps the unsmoothed analyte image for downstream use and (ii) creates a derivative image that
is smoothed using the specified kernel. This allows either the smoothed or the unsmoothed version
of the image to be used in any downstream modules as appropriate.:
# No smoothing
seed_sptf[cxt]=none
seed_smo[cxt]=0
# Gaussian kernel (fslmaths) of FWHM 6 mm
seed_sptf[cxt]=gaussian
seed_smo[cxt]=6
# SUSAN kernel (FSL's SUSAN) of FWHM 4 mm
seed_sptf[cxt]=susan
seed_smo[cxt]=4
# Uniform kernel (AFNI's 3dBlurToFWHM) of FWHM 5 mm
seed_sptf[cxt]=uniform
seed_smo[cxt]=5
seed_sptf
specifies the type of spatial filter to apply for smoothing, while seed_smo
specifies the full-width at half-maximum (FWHM) of the smoothing kernel in mm.
- Gaussian smoothing applies the same Gaussian smoothing kernel across the entire volume.
- SUSAN-based smoothing restricts mixing of signals from disparate tissue classes (Smith and Brady, 1997).
- Uniform smoothing applies smoothing to all voxels until the smoothness computed at every voxel attains the target value.
- Uniform smoothing may be used as a compensatory mechanism to reduce the effects of subject motion on the final processed image (Scheinost et al., 2014).
seed_rerun
¶
Ordinarily, each module will detect whether a particular analysis has run to completion before beginning it. If re-running is disabled, then the module will immediately skip to the next stage of analysis. Otherwise, any completed analyses will be repeated.If you change the run parameters, you should rerun any modules downstream of the change.:
# Skip processing steps if the pipeline detects the expected output
seed_rerun[cxt]=0
# Repeat all processing steps
seed_rerun[cxt]=1
seed_cleanup
¶
Modules often produce numerous intermediate temporary files and images during the course of an analysis. In many cases, these temporary files are undesirable and unnecessarily consume disk space. If cleanup is enabled, any files stamped as temporary will be deleted when a module successfully runs to completion. If a module fails to detect the output that it expects, then temporary files will be retained to facilitate error diagnosis.:
# Remove temporary files
seed_cleanup[cxt]=1
# Retain temporary files
seed_cleanup[cxt]=0
Expected outputs
¶
- A sub-directory of
seed_names
is created inseed
directory. The directory constist of::
- prefix_connectivity_{seed_name}_seed.nii.gz # seed mask in BOLD space
- prefix_connectivity_{seed_name}_sm*.nii.gz # seed correlation map
- prefix_connectivity_{seed_name}Z_sm*.nii.gz # Fisherz transfromed seed correlation map
- prefix_connectivity_{seed_name}_ts.1D # time series of seed point