Skip to content

Commit 8867c9d

Browse files
authored
DOC: Include template metadata information when resampling BOLD to surface (#3544)
Follow up on #3461 to include template information <details> <summary>Sampler boilerplate text</summary> The BOLD time-series were resampled onto the left/right-symmetric template “fsLR” using the Connectome Workbench (Glasser et al. 2013). The BOLD time-series were resampled onto the native surface of the subject using the “ribbon-constrained” method and then dilated by 10 mm.Grayordinates files (Glasser et al. 2013) containing 91k samples were also generated with surface data transformed directly to fsLR space and subcortical data transformed to 2 mm resolution MNI152NLin6Asym space. The BOLD series was resampled to OpenNeuro Average (onavg) surface template [Feilong et al. (2024); TemplateFlow ID: onavg] using the Connectome Workbench. All resamplings can be performed with a single interpolation step by composing all the pertinent transformations (i.e. head-motion transform matrices, susceptibility distortion correction when available, and co-registrations to anatomical and output spaces). Gridded (volumetric) resamplings were performed using nitransforms, configured with cubic B-spline interpolation. Non-gridded (surface) resamplings were performed using the Connectome Workbench.Grayordinate “dscalar” files containing 91k samples were resampled onto fsLR using the Connectome Workbench (Glasser et al. 2013). </details>
2 parents 9d69a9c + d88a28f commit 8867c9d

File tree

1 file changed

+15
-4
lines changed

1 file changed

+15
-4
lines changed

fmriprep/workflows/bold/resampling.py

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -576,9 +576,8 @@ def init_wb_vol_surf_wf(
576576
workflow = Workflow(name=name)
577577
workflow.__desc__ = """\
578578
The BOLD time-series were resampled onto the native surface of the subject
579-
using the "ribbon-constrained" method
579+
using the "ribbon-constrained" method{' and then dilated by 10 mm' * dilate}.
580580
"""
581-
workflow.__desc__ += ' and then dilated by 10 mm.' if dilate else '.'
582581

583582
inputnode = pe.Node(
584583
niu.IdentityInterface(
@@ -677,7 +676,7 @@ def init_wb_surf_surf_wf(
677676
678677
from fmriprep.workflows.bold.resampling import init_wb_surf_surf_wf
679678
wf = init_wb_surf_surf_wf(
680-
space='fsLR',
679+
template='fsLR',
681680
density='32k',
682681
omp_nthreads=1,
683682
mem_gb=1,
@@ -782,7 +781,7 @@ def init_wb_surf_surf_wf(
782781
resample_to_template = pe.Node(
783782
MetricResample(method='ADAP_BARY_AREA', area_surfs=True),
784783
name='resample_to_template',
785-
mem_gb=1,
784+
mem_gb=mem_gb,
786785
n_procs=omp_nthreads,
787786
)
788787

@@ -806,6 +805,18 @@ def init_wb_surf_surf_wf(
806805
]),
807806
]) # fmt:skip
808807

808+
# Fetch template metadata
809+
template_meta = tf.get_metadata(template.split(':')[0])
810+
template_refs = ['@{}'.format(template.split(':')[0].lower())]
811+
if template_meta.get('RRID', None):
812+
template_refs += [f'RRID:{template_meta["RRID"]}']
813+
814+
workflow.__desc__ = f"""\
815+
The BOLD series was resampled to *{template_meta['Name']}*
816+
[{', '.join(template_refs)}; TemplateFlow ID: {template}] using
817+
the Connectome Workbench.
818+
"""
819+
809820
return workflow
810821

811822

0 commit comments

Comments
 (0)