aslprep.interfaces package
Nipype interfaces for aslprep.
- class ASLSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SimpleInterface
Copy the x-form matrices from hdr_file to out_file.
Clearly that’s wrong.
- Mandatory Inputs:
in_func (a pathlike object or string representing an existing file) – Input ASL time-series (4D file).
- Optional Inputs:
confounds_file (a pathlike object or string representing an existing file) – BIDS’ _confounds.tsv file.
confounds_list (a list of at least 1 items which are a string or a tuple of the form: (a string, a string or None) or a tuple of the form: (a string, a string or None, a string or None)) – List of headers to extract from the confounds_file.
in_mask (a pathlike object or string representing an existing file) – 3D brain mask.
in_segm (a pathlike object or string representing an existing file) – Resampled segmentation.
str_or_tuple (a string or a tuple of the form: (a string, a string or None) or a tuple of the form: (a string, a string or None, a string or None))
tr (a float or None) – The repetition time. (Nipype default value:
None
)
- Outputs:
out_file (a pathlike object or string representing an existing file) – Written file path.
- class AboutSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SummaryInterface
A basic summary of the ASLPrep run.
- Optional Inputs:
command (a string) – ASLPREP command.
version (a string) – ASLPREP version.
- Outputs:
out_report (a pathlike object or string representing an existing file) – HTML segment containing summary.
- class CBFSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SimpleInterface
Prepare an CBF summary plot for the report.
- Mandatory Inputs:
cbf (a pathlike object or string representing an existing file)
label (a string) – Label.
ref_vol (a pathlike object or string representing an existing file)
vmax (an integer) – Max value of asl.
- Outputs:
out_file (a pathlike object or string representing an existing file) – Written file path.
- class CBFtsSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SimpleInterface
Prepare an CBF summary plot for the report.
- Mandatory Inputs:
cbf_ts (a pathlike object or string representing an existing file) – cbf time series.
seg_file (a pathlike object or string representing an existing file) – Seg_file.
tr (a float) – TR.
- Optional Inputs:
conf_file (a pathlike object or string representing an existing file) – Confound file .
score_file (a pathlike object or string representing an existing file) – Scorexindex file .
- Outputs:
out_file (a pathlike object or string representing an existing file) – Written file path.
- class DerivativesDataSink(allowed_entities=None, out_path_base=None, **inputs)[source]
Bases:
DerivativesDataSink
Store derivative files.
A child class of the niworkflows DerivativesDataSink, using aslprep’s configuration files.
- Mandatory Inputs:
in_file (a list of items which are a pathlike object or string representing an existing file) – The object to be saved.
source_file (a list of items which are a pathlike object or string representing a file) – The source file(s) to extract entities from.
- Optional Inputs:
base_directory (a string or os.PathLike object) – Path to the base directory for storing data.
check_hdr (a boolean) – Fix headers of NIfTI outputs. (Nipype default value:
True
)compress (a list of items which are a boolean or None) – Whether
in_file
should be compressed (True), uncompressed (False) or left unmodified (None, default). (Nipype default value:[]
)data_dtype (a string) – NumPy datatype to coerce NIfTI data to, or source tomatch the input file dtype.
dismiss_entities (a list of items which are a string or None) – A list entities that will not be propagated from the source file. (Nipype default value:
[]
)meta_dict (a dictionary with keys which are a value of class ‘str’ and with values which are any value) – An input dictionary containing metadata.
- Outputs:
compression (a list of items which are a boolean or None) – Whether
in_file
should be compressed (True), uncompressed (False) or left unmodified (None).fixed_hdr (a list of items which are a boolean) – Whether derivative header was fixed.
out_file (a list of items which are a pathlike object or string representing an existing file)
out_meta (a list of items which are a pathlike object or string representing an existing file)
- out_path_base = 'aslprep'
- class FunctionalSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SummaryInterface
A summary of a functional run, with QC measures included.
- Mandatory Inputs:
distortion_correction (a string) – Susceptibility distortion correction method.
pe_direction (None or ‘i’ or ‘i-’ or ‘j’ or ‘j-’) – Phase-encoding direction detected.
registration (‘FSL’ or ‘FreeSurfer’) – Functional/anatomical registration method.
registration_dof (6 or 9 or 12) – Registration degrees of freedom.
registration_init (‘register’ or ‘header’) – Whether to initialize registration with the “header” or by centering the volumes (“register”).
tr (a float) – Repetition time.
- Optional Inputs:
confounds_file (a pathlike object or string representing an existing file) – Confounds file.
fallback (a boolean) – Boundary-based registration rejected.
qc_file (a pathlike object or string representing an existing file) – Qc file.
slice_timing (False or True or ‘TooShort’) – Slice timing correction used. (Nipype default value:
False
)
- Outputs:
out_report (a pathlike object or string representing an existing file) – HTML segment containing summary.
- class GatherConfounds(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SimpleInterface
Combine various sources of confounds in one TSV file.
- Optional Inputs:
dvars (a pathlike object or string representing an existing file) – File containing DVARS.
fd (a pathlike object or string representing an existing file) – Input framewise displacement.
motion (a pathlike object or string representing an existing file) – Input motion parameters.
rmsd (a pathlike object or string representing an existing file) – Input RMS framewise displacement.
signals (a pathlike object or string representing an existing file) – Input signals.
std_dvars (a pathlike object or string representing an existing file) – File containing standardized DVARS.
- Outputs:
confounds_file (a pathlike object or string representing an existing file) – Output confounds file.
confounds_list (a list of items which are a string) – List of headers.
- class SubjectSummary(from_file=None, resource_monitor=None, **inputs)[source]
Bases:
SummaryInterface
A summary describing the subject’s data as a whole.
- Optional Inputs:
asl (a list of items which are a pathlike object or string representing an existing file or a list of items which are a pathlike object or string representing an existing file) – ASL functional series.
nstd_spaces (a list of items which are a string) – List of non-standard spaces.
std_spaces (a list of items which are a string) – List of standard spaces.
subject_id (a string) – Subject ID.
subjects_dir (a pathlike object or string representing a directory) – FreeSurfer subjects directory.
t1w (a list of items which are a pathlike object or string representing an existing file) – T1w structural images.
t2w (a list of items which are a pathlike object or string representing an existing file) – T2w structural images.
- Outputs:
out_report (a pathlike object or string representing an existing file) – HTML segment containing summary.
subject_id (a string) – FreeSurfer subject ID.
- class T2SMap(command=None, terminal_output=None, write_cmdline=False, **inputs)[source]
Bases:
CommandLine
Wrapped executable:
t2smap
.Run the tedana T2* workflow to generate a T2* map and create a combined time series.
Example
>>> from fmriprep.interfaces import multiecho >>> t2smap = multiecho.T2SMap() >>> t2smap.inputs.in_files = ['sub-01_run-01_echo-1_bold.nii.gz', 'sub-01_run-01_echo-2_bold.nii.gz', 'sub-01_run-01_echo-3_bold.nii.gz'] >>> t2smap.inputs.echo_times = [0.013, 0.027, 0.043] >>> t2smap.cmdline 't2smap -d sub-01_run-01_echo-1_bold.nii.gz sub-01_run-01_echo-2_bold.nii.gz sub-01_run-01_echo-3_bold.nii.gz -e 13.0 27.0 43.0 --fittype curvefit'
- Mandatory Inputs:
echo_times (a list of at least 3 items which are a float) – Echo times. Maps to a command-line argument:
-e %s
(position: 2).in_files (a list of at least 3 items which are a pathlike object or string representing an existing file) – Multi-echo BOLD EPIs. Maps to a command-line argument:
-d %s
(position: 1).
- Optional Inputs:
args (a string) – Additional parameters to the command. Maps to a command-line argument:
%s
.environ (a dictionary with keys which are a bytes or None or a value of class ‘str’ and with values which are a bytes or None or a value of class ‘str’) – Environment variables. (Nipype default value:
{}
)fittype (‘curvefit’ or ‘loglin’) – Desired fitting method: “loglin” means that a linear model is fit to the log of the data. “curvefit” means that a more computationally demanding monoexponential model is fit to the raw data. Maps to a command-line argument:
--fittype %s
(position: 3). (Nipype default value:curvefit
)
- Outputs:
optimal_comb (a pathlike object or string representing an existing file) – Optimally combined ME-EPI time series.
s0_map (a pathlike object or string representing an existing file) – Limited S0 map.
t2star_map (a pathlike object or string representing an existing file) – Limited T2* map.
Submodules
- aslprep.interfaces.ants module
- aslprep.interfaces.bids module
- aslprep.interfaces.cbf_computation module
- aslprep.interfaces.confounds module
- aslprep.interfaces.ge module
- aslprep.interfaces.multiecho module
- aslprep.interfaces.parcellation module
- aslprep.interfaces.plotting module
- aslprep.interfaces.qc module
- aslprep.interfaces.reports module