qsirecon.utils.bids module

exception qsirecon.utils.bids.BIDSError(message, bids_root)[source]

Bases: ValueError

exception qsirecon.utils.bids.BIDSWarning[source]

Bases: RuntimeWarning

qsirecon.utils.bids.clean_datasinks(workflow: Workflow, qsirecon_suffix: str | None) Workflow[source]

Overwrite the base_directory of Datasinks.

qsirecon.utils.bids.collect_participants(bids_dir, participant_label=None, strict=False, bids_validate=True)[source]

List the participants under the BIDS root and checks that participants designated with the participant_label argument exist in that folder.

Returns the list of participants to be finally processed.

Requesting all subjects in a BIDS directory root:

>>> collect_participants('ds114')
['01', '02', '03', '04', '05', '06', '07', '08', '09', '10']

Requesting two subjects, given their IDs:

>>> collect_participants('ds114', participant_label=['02', '04'])
['02', '04']

Requesting two subjects, given their IDs (works with ‘sub-’ prefixes):

>>> collect_participants('ds114', participant_label=['sub-02', 'sub-04'])
['02', '04']

Requesting two subjects, but one does not exist:

>>> collect_participants('ds114', participant_label=['02', '14'])
['02']
>>> collect_participants('ds114', participant_label=['02', '14'],
...                      strict=True)  
Traceback (most recent call last):
qsirecon.utils.bids.BIDSError:
...
qsirecon.utils.bids.validate_input_dir(exec_env, bids_dir, participant_label)[source]
qsirecon.utils.bids.write_bidsignore(deriv_dir)[source]
qsirecon.utils.bids.write_derivative_description(bids_dir, deriv_dir, dataset_links=None)[source]