aslprep.workflows.asl.resampling module

Workflows for resampling data.

init_asl_preproc_trans_wf(mem_gb, omp_nthreads, use_compression=True, split_file=False, interpolation='LanczosWindowedSinc', name='asl_preproc_trans_wf')[source]

Resample in native (original) space.

This workflow resamples the input fMRI in its native (original) space in a “single shot” from the original asl series.

Workflow Graph

(Source code)

Parameters:

  • mem_gb (float) – Size of asl file in GB

  • omp_nthreads (int) – Maximum number of threads an individual process may use

  • name (str) – Name of workflow (default: asl_std_trans_wf)

  • use_compression (bool) – Save registered asl series as .nii.gz

  • split_file (bool) – Whether the input file should be split (it is a 4D file) or it is a list of 3D files (default False, do not split)

  • interpolation (str) – Interpolation type to be used by ANTs’ applyTransforms (default 'LanczosWindowedSinc')

Inputs:

  • asl_file – Individual 3D volumes, not motion corrected

  • asl_mask – Skull-stripping mask of reference image

  • name_source – asl series NIfTI file Used to recover original information lost during processing

  • hmc_xforms – List of affine transforms aligning each volume to ref_image in ITK format

  • fieldwarp – a DFM in ITK format

Outputs:

  • asl – asl series, resampled in native space, including all preprocessing

  • asl_mask – asl series mask calculated with the new time-series

  • aslref – asl reference image: an average-like 3D image of the time-series

  • aslref_brain – Same as aslref, but once the brain mask has been applied

init_asl_std_trans_wf(mem_gb, omp_nthreads, spaces, is_multi_pld=False, scorescrub=False, basil=False, generate_reference=True, use_compression=True, name='asl_std_trans_wf')[source]

Sample ASL into standard space with a single-step resampling of the original ASL series.

Important

This workflow provides two outputnodes. One output node (with name poutputnode) will be parameterized in a Nipype sense (see Nipype iterables), and a second node (outputnode) will collapse the parameterized outputs into synchronous lists of the output fields listed below.

Workflow Graph

(Source code)

Parameters:

  • mem_gb (float) – Size of ASL file in GB

  • omp_nthreads (int) – Maximum number of threads an individual process may use

  • spaces (SpatialReferences) – A container for storing, organizing, and parsing spatial normalizations. Composed of Reference objects representing spatial references. Each Reference contains a space, which is a string of either TemplateFlow template IDs.

  • name (str) – Name of workflow (default: asl_std_trans_wf)

  • use_compression (bool) – Save registered ASL series as .nii.gz

Inputs:

  • anat_to_template_xfm – List of anatomical-to-standard space transforms generated during spatial normalization.

  • asl_mask – Skull-stripping mask of reference image

  • asl_split – Individual 3D volumes, not motion corrected

  • fieldwarp – a DFM in ITK format

  • hmc_xforms – List of affine transforms aligning each volume to ref_image in ITK format

  • aslref_to_anat_xfm – Affine transform from ref_asl_brain to T1 space (ITK format)

  • name_source – ASL series NIfTI file Used to recover original information lost during processing

  • templates – List of templates that were applied as targets during spatial normalization.

Outputs:

  • asl_std – ASL series, resampled to template space

  • cbf_ts_std, *cbf – cbf series, resampled to template space

  • aslref_std – Reference, contrast-enhanced summary of the ASL series, resampled to template space

  • asl_mask_std – ASL series mask in template space

  • template – Template identifiers synchronized correspondingly to previously described outputs.