💡 Update comments based on default preconfig

Author: ChildMindInstituteCNL

CPAC/resources/configs/pipeline_config_abcd-options.yml

@@ -6,24 +6,20 @@
 # http://fcp-indi.github.io for more info.
 #
 # Tip: This file can be edited manually with a text editor for quick modifications.
-
 FROM: default
 
+pipeline_setup:
 
-pipeline_setup: 
   # Name for this pipeline configuration - useful for identification.
+  # This string will be sanitized and used in filepaths
   pipeline_name: cpac_anat
+  system_config:
 
-  working_directory:
-    # Deletes the contents of the Working Directory after running.
-    # This saves disk space, but any additional preprocessing or analysis will have to be completely re-run.
-    remove_working_dir: Off
-
-  system_config: 
     # Select Off if you intend to run CPAC on a single machine.
     # If set to On, CPAC will attempt to submit jobs through the job scheduler / resource manager selected below.
-    on_grid: 
-      SGE: 
+    on_grid:
+      SGE:
+
         # SGE Parallel Environment to use when running CPAC.
         # Only applies when you are running on a grid or compute cluster using SGE.
         parallel_environment: cpac
@@ -41,166 +37,143 @@ pipeline_setup:
     # If you have specified an FSL path in your .bashrc file, this path will be set automatically.
     FSLDIR: FSLDIR
 
-  Amazon-AWS: 
+  working_directory:
+
+    # Deletes the contents of the Working Directory after running.
+    # This saves disk space, but any additional preprocessing or analysis will have to be completely re-run.
+    remove_working_dir: Off
+
+  Amazon-AWS:
+
     # Enable server-side 256-AES encryption on data to the S3 bucket
     s3_encryption: On
 
-anatomical_preproc: 
-  # Non-local means filtering via ANTs DenoiseImage
-  non_local_means_filtering:
-    run: [Off]
+anatomical_preproc:
+  brain_extraction:
+    FSL-BET:
+
+      # Mask created along with skull stripping. It should be `On`, if selected functionalMasking :  ['Anatomical_Refined'] and `FSL` as skull-stripping method.
+      mask_boolean: Off
 
   # N4 bias field correction via ANTs
   n4_bias_field_correction:
+
+    # this is a fork option
     run: [On]
 
-  brain_extraction: 
-    FSL-BET: 
-      # Mask created along with skull stripping. It should be `On`, if selected functionalMasking :  ['Anatomical_Refined'] and `FSL` as skull-stripping method.
-      mask_boolean: Off
+segmentation:
+  tissue_segmentation:
+    Template_Based:
 
-segmentation: 
-  tissue_segmentation: 
-    # option parameters
-    FSL-FAST: 
-      use_priors: 
-        # Full path to a directory containing binarized prior probability maps.
-        # These maps are included as part of the 'Image Resource Files' package available on the Install page of the User Guide.
-        # It is not necessary to change this path unless you intend to use non-standard priors.
-        priors_path: $FSLDIR/data/standard/tissuepriors/2mm
-
-    Template_Based: 
       # These masks should be in the same space of your registration template, e.g. if
       # you choose 'EPI Template' , below tissue masks should also be EPI template tissue masks.
       #
       # Options: ['T1_Template', 'EPI_Template']
       template_for_segmentation: []
 
-      # These masks are included as part of the 'Image Resource Files' package available
-      # on the Install page of the User Guide.
-
-      # Full path to a binarized White Matter mask.
-      WHITE: $FSLDIR/data/standard/tissuepriors/2mm/avg152T1_white_bin.nii.gz
-
-      # Full path to a binarized Gray Matter mask.
-      GRAY: $FSLDIR/data/standard/tissuepriors/2mm/avg152T1_gray_bin.nii.gz
+registration_workflows:
+  anatomical_registration:
+    registration:
+      FSL-FNIRT:
 
-      # Full path to a binarized CSF mask.
-      CSF: $FSLDIR/data/standard/tissuepriors/2mm/avg152T1_csf_bin.nii.gz
+        # Reference mask for FSL registration.
+        ref_mask: $$FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain_mask_dil.nii.gz
 
-registration_workflows: 
-  anatomical_registration: 
     # Template to be used during registration.
     # It is not necessary to change this path unless you intend to use a non-standard template.
-    T1w_brain_template: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain.nii.gz
+    T1w_brain_template: $$FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain.nii.gz
 
     # Template to be used during registration.
     # It is not necessary to change this path unless you intend to use a non-standard template.
-    T1w_template: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}.nii.gz
+    T1w_template: $$FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}.nii.gz
 
     # Register skull-on anatomical image to a template.
     reg_with_skull: Off
 
-    registration: 
-      FSL-FNIRT: 
-        # Reference mask for FSL registration.
-        ref_mask: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain_mask_dil.nii.gz
+  functional_registration:
+    coregistration:
 
-  functional_registration: 
-    coregistration: 
+      # functional (BOLD/EPI) registration to anatomical (structural/T1)
       run: Off
+      boundary_based_registration:
 
-      boundary_based_registration: 
         # this is a fork point
         #   run: [On, Off] - this will run both and fork the pipeline
         run: [Off]
 
-    EPI_registration: 
-      ANTs: 
-        # EPI registration configuration - synonymous with T1_registration
-        # parameters under anatomical registration above
-        parameters: 
-      FSL-FNIRT: 
-        # Identity matrix used during FSL-based resampling of BOLD-space data throughout the pipeline.
-        # It is not necessary to change this path unless you intend to use a different template.
-        identity_matrix: $FSLDIR/etc/flirtsch/ident.mat
+    func_registration_to_template:
 
-    func_registration_to_template: 
+      # these options modify the application (to the functional data), not the calculation, of the
+      # T1-to-template and EPI-to-template transforms calculated earlier during registration
+      # apply the functional-to-template (T1 template) registration transform to the functional data
       run: Off
+      target_template:
+        T1_template:
 
-      target_template: 
-        # option parameters
-        T1_template: 
           # Standard Skull Stripped Template. Used as a reference image for functional registration.
           # This can be different than the template used as the reference/fixed for T1-to-template registration.
-          T1w_brain_template_funcreg: $FSLDIR/data/standard/MNI152_T1_${func_resolution}_brain.nii.gz
+          T1w_brain_template_funcreg: $$FSLDIR/data/standard/MNI152_T1_${func_resolution}_brain.nii.gz
 
           # Standard Anatomical Brain Image with Skull.
           # This can be different than the template used as the reference/fixed for T1-to-template registration.
-          T1w_template_funcreg: $FSLDIR/data/standard/MNI152_T1_${func_resolution}.nii.gz
+          T1w_template_funcreg: $$FSLDIR/data/standard/MNI152_T1_${func_resolution}.nii.gz
+
+    EPI_registration:
+      ANTs:
+
+        # EPI registration configuration - synonymous with T1_registration
+        # parameters under anatomical registration above
+        parameters:
+
+      FSL-FNIRT:
 
-functional_preproc: 
+        # Identity matrix used during FSL-based resampling of BOLD-space data throughout the pipeline.
+        # It is not necessary to change this path unless you intend to use a different template.
+        identity_matrix: $$FSLDIR/etc/flirtsch/ident.mat
+
+functional_preproc:
   run: Off
+  distortion_correction:
 
-  distortion_correction: 
-    # using: ['PhaseDiff', 'Blip']
+    # using: ['PhaseDiff', 'Blip', 'Blip-FSL-TOPUP']
     #   PhaseDiff - Perform field map correction using a single phase difference image, a subtraction of the two phase images from each echo. Default scanner for this method is SIEMENS.
     #   Blip - Uses AFNI 3dQWarp to calculate the distortion unwarp for EPI field maps of opposite/same phase encoding direction.
-    #   NOTE:
-    #     this is NOT a fork point - instead, the technique used will depend on what type of distortion correction field data accompanies the dataset
-    #     for example, phase-difference field maps will lead to phase-difference distortion correction, and phase-encoding direction field maps will lead to blip-up/blip-down
+    #   Blip-FSL-TOPUP - Uses FSL TOPUP to calculate the distortion unwarp for EPI field maps of opposite/same phase encoding direction.
     using: []
 
-nuisance_corrections: 
-  2-nuisance_regression: 
+nuisance_corrections:
+  2-nuisance_regression:
+
     # this is a fork point
     #   run: [On, Off] - this will run both and fork the pipeline
     run: [Off]
 
     # Select which nuisance signal corrections to apply
-    Regressors: 
-    # Standard Lateral Ventricles Binary Mask
-    # used in CSF mask refinement for CSF signal-related regressions
-    lateral_ventricles_mask: $FSLDIR/data/atlases/HarvardOxford/HarvardOxford-lateral-ventricles-thr25-2mm.nii.gz
+    Regressors:
 
-timeseries_extraction: 
+timeseries_extraction:
   run: Off
 
-seed_based_correlation_analysis: 
-  # SCA - Seed-Based Correlation Analysis
-  # For each extracted ROI Average time series, CPAC will generate a whole-brain correlation map.
-  # It should be noted that for a given seed/ROI, SCA maps for ROI Average time series will be the same.
-  run: Off
+amplitude_low_frequency_fluctuation:
 
-amplitude_low_frequency_fluctuation: 
   # ALFF & f/ALFF
-  # Calculate Amplitude of Low Frequency Fluctuations (ALFF) and and fractional ALFF (f/ALFF) for all voxels.
+  # Calculate Amplitude of Low Frequency Fluctuations (ALFF) and fractional ALFF (f/ALFF) for all voxels.
   run: Off
 
-regional_homogeneity: 
+regional_homogeneity:
+
   # ReHo
   # Calculate Regional Homogeneity (ReHo) for all voxels.
   run: Off
 
-voxel_mirrored_homotopic_connectivity: 
+voxel_mirrored_homotopic_connectivity:
+
   # VMHC
   # Calculate Voxel-mirrored Homotopic Connectivity (VMHC) for all voxels.
   run: Off
 
-  symmetric_registration: 
-    # Included as part of the 'Image Resource Files' package available on the Install page of the User Guide.
-    # It is not necessary to change this path unless you intend to use a non-standard symmetric template.
-    T1w_brain_template_symmetric: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain_symmetric.nii.gz
-
-    # Included as part of the 'Image Resource Files' package available on the Install page of the User Guide.
-    # It is not necessary to change this path unless you intend to use a non-standard symmetric template.
-    T1w_template_symmetric: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_symmetric.nii.gz
-
-    # Included as part of the 'Image Resource Files' package available on the Install page of the User Guide.
-    # It is not necessary to change this path unless you intend to use a non-standard symmetric template.
-    dilated_symmetric_brain_mask: $FSLDIR/data/standard/MNI152_T1_${resolution_for_anat}_brain_mask_symmetric_dil.nii.gz
+network_centrality:
 
-network_centrality: 
   # Calculate Degree, Eigenvector Centrality, or Functional Connectivity Density.
   run: Off
 
@@ -210,15 +183,16 @@ network_centrality:
 
   # Full path to a NIFTI file describing the mask. Centrality will be calculated for all voxels within the mask.
   template_specification_file: s3://fcp-indi/resources/cpac/resources/mask-thr50-3mm.nii.gz
+  eigenvector_centrality:
 
-  eigenvector_centrality: 
     # Enable/Disable eigenvector centrality by selecting the connectivity weights
     #   weight_options: ['Binarized', 'Weighted']
     # disable this type of centrality with:
     #   weight_options: []
     weight_options: [Binarized, Weighted]
 
-  local_functional_connectivity_density: 
+  local_functional_connectivity_density:
+
     # Select the type of threshold used when creating the lFCD adjacency matrix.
     # options:
     #   'Significance threshold', 'Correlation threshold'
@@ -229,9 +203,3 @@ network_centrality:
     # Sparsity value for Sparsity Threshold
     # Pearson's r value for Correlation Threshold
     correlation_threshold: 0.001
-
-# PACKAGE INTEGRATIONS
-# --------------------
-PyPEER: 
-  # Template-space eye mask
-  eye_mask_path: $FSLDIR/data/standard/MNI152_T1_${func_resolution}_eye_mask.nii.gz