Reparcellation Tool - McIntosh-Lab/tvb-ukbb GitHub Wiki

The TVB-UKBB pipeline generates multiple parcellation-specific outputs during the regular processing of a subject. Users may choose to process the same subject with multiple different parcellations.

Instead of re-running the entire pipeline and needlessly repeating non-parcellation specific processing, the reparcellation tool only executes parcellation-specific portions of the regular pipeline. This allows users to generate new parcellation-specific outputs (including QC report and TVB inputs) for a subject that has previously been processed by the pipeline. This does not overwrite existing parcellation-specific outputs for a DIFFERENT parcellation.

Running the Reparcellation Tool

The subject you are processing with the reparcellation tool MUST have been already processed with the regular pipeline and MUST contain parcellation-specific outputs with parcellation-specific filenames (for your original parcellation). If your subject has been processed by an earlier version of the regular TVB-UKBB pipeline and does not contain output files with parcellation-specific filenames, then you can rename their parcellation-specific outputs to contain the parcellation name with bb_pipeline_tools/parcellation_filename_updater.sh. Once the filenames are updated for your subject, you can process it with the reparcellation tool.

Running a subject with the reparcellation tool is almost the same as running the subject through the regular pipeline. See Basic Usage. The only change is that init_vars needs the following updates:

  • PARC_NAME to your desired parcellation name. Note that parcellation-specific output files will be appended with this parcellation name.
  • PARC_LUT to your desired parcellation lookup table.
  • PARC_IMG to your desired parcellation image.
  • REPARCELLATE to true