BIBSNet OutputsπŸ”—

BIBSNet generates brain segmentations, brain masks, and ROI volumes in native T1w and/or T2w space (depending on the presence of T1w and/or T2w files in the input BIDS):

  • Brain segmentation files in native T1w/T2w space
  • Brain mask files in native T1w/T2w space
  • Brain volumes computed for segmented ROIs in native T1w/T2w space

The derivative output folder is organized as follows. Note that each image file (.nii.gz) and .tsv is accompanied by a sidecar .json file that contains metadata for that file:

derivatives/
|_ bibsnet/
   |_ sub-01/
      |_ ses-A/
        |_ anat/  
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-aseg_dseg.nii.gz   # Brain segmentation(s)
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-aseg_dseg.json
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-brain_mask.nii.gz  # Brain mask(s)
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-brain_mask.json
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-aseg_volumes.tsv   # Brain ROI volumes
           |_ sub-01_ses-A_space-<T1w|T2w>_desc-aseg_volumes.json

Sidecar JSONsπŸ”—

A sidecar JSON will be made for each of the .nii.gz files in derivatives. Below is an example JSON for a file sub-01_ses-A_space-T1w_desc-aseg_dseg.json generated by BIBSnet version 3.0.0 and above

{
  "Name": "BIBSnet Outputs",
  "BIDSVersion": "1.4.0",
  "DatasetType": "derivative",
  "GeneratedBy": [
    {
      "Name": "BIBSnet",
      "Version": "3.0.0",
      "Container": {
        "Type": "docker",
        "Tag": "dcanumn/bibsnet:3.0.0"
        }
    }
  ],
  "SpatialReference":"sub-01/ses-A/anat/sub-01_ses-A_T1w.nii.gz"
}

Working DirectoryπŸ”—

β”œβ”€β”€ work_dir/
    β”œβ”€β”€ prebibsnet/
    |   β”œβ”€β”€ sub-01/
    |       β”œβ”€β”€ ses-A/
    |           β”œβ”€β”€ averaged/
    |           |   β”œβ”€β”€ <T1w|T2w>_denoise_and_bfcorrect/
    |           |   |   β”œβ”€β”€ clip/
    |           |   |   β”œβ”€β”€ denoise/
    |           |   |   β”œβ”€β”€ final_clip/
    |           |   |   β”œβ”€β”€ n4_correct/
    |           |   |   β”œβ”€β”€ d3.js
    |           |   |   β”œβ”€β”€graph.json
    |           |   |   β”œβ”€β”€graph1.json
    |           |   |   β”œβ”€β”€index.html
    |           |   β”œβ”€β”€ sub-150712_ses-V02_0000.nii.gz
    |           |   β”œβ”€β”€ sub-150712_ses-V02_0001.nii.gz
    |           |
    |           β”œβ”€β”€ cropped/
    |           |   β”œβ”€β”€ T1w/
    |           |   |   β”œβ”€β”€ brainmask.nii.gz
    |           |   |   β”œβ”€β”€ crop2full.mat
    |           |   |   β”œβ”€β”€ sub-01_ses-A_0000.nii.gz
    |           |   β”œβ”€β”€ T2w/
    |           |       β”œβ”€β”€ brainmask.nii.gz
    |           |       β”œβ”€β”€ crop2full.mat
    |           |       β”œβ”€β”€ sub-01_ses-A_0001.nii.gz
    |           |
    |           β”œβ”€β”€ resized/
    |               β”œβ”€β”€ ACPC_align/
    |               |   β”œβ”€β”€ ACPC_T1w_registered_to_T1w.nii.gz
    |               |   β”œβ”€β”€ ACPC_T2w_registered_to_T1w.nii.gz
    |               |   β”œβ”€β”€ ACPC_aligned_<T1w|T2w>.nii.gz
    |               |   β”œβ”€β”€ <T1w|T2w>_acpc2rigidbody.mat
    |               |   β”œβ”€β”€ <T1w|T2w>_crop2acpc.mat
    |               |   β”œβ”€β”€ <T1w|T2w>_full2acpc.mat
    |               |   β”œβ”€β”€ <T1w|T2w>_full2crop.mat
    |               |   β”œβ”€β”€ T2w_to_rigidbody.mat
    |               |   β”œβ”€β”€ cropT2tocropT1.mat
    |               |   β”œβ”€β”€ crop_<T1w|T2w>_to_BIBS_template.mat
    |               |   β”œβ”€β”€ preBIBSnet_final_0000.nii.gz
    |               |   β”œβ”€β”€ preBIBSnet_final_0001.nii.gz
    |               |
    |               β”œβ”€β”€ xfms/
    |                   β”œβ”€β”€ <T1w|T2w>_to_BIBS.nii.gz
    |                   β”œβ”€β”€ T2w_registered_to_T1w.nii.gz
    |                   β”œβ”€β”€ cropT2tocropT1.mat
    |                   β”œβ”€β”€ crop_<T1w|T2w>_to_BIBS_template.mat
    |                   β”œβ”€β”€ full2crop<T1w|T2w>.mat
    |                   β”œβ”€β”€ full2cropT2toT1.mat
    |                   β”œβ”€β”€ full_crop_<T1w|T2w>_to_BIBS_template.mat
    |                   β”œβ”€β”€ preBIBSnet_final_0000.nii.gz
    |                   β”œβ”€β”€ preBIBSnet_final_0001.nii.gz
    |
    β”œβ”€β”€ bibsnet/
    |   β”œβ”€β”€ sub-01/
    |       β”œβ”€β”€ ses-A/
    |           β”œβ”€β”€ input/
    |           |   β”œβ”€β”€ sub-01_ses-A_optimal_resized_0000.nii.gz
    |           |   β”œβ”€β”€ sub-01_ses-A_optimal_resized_0001.nii.gz
    |           β”œβ”€β”€ output/
    |               β”œβ”€β”€ plans.pkl
    |               β”œβ”€β”€ prediction_time.txt
    |               β”œβ”€β”€ sub-01_ses-A_optimal_resized.nii.gz
    |
    β”œβ”€β”€ postbibsnet/
        β”œβ”€β”€ sub-01/
            β”œβ”€β”€ ses-A/
                β”œβ”€β”€ preBIBSnet_full_crop_T1w_to_BIBS_template.mat
                β”œβ”€β”€ preBIBSnet_full_crop_T2w_to_BIBS_template.mat
                β”œβ”€β”€ seg_reg_to_T1w_native.mat
                β”œβ”€β”€ seg_reg_to_T2w_native.mat