Skip to content
precon_all surface pipline
Shell Python MATLAB
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


precon_all surface pipline

precon_all is an animal surface generation pipeline that can be easily adapted to work with multiple species. The curent example we'l use is the pig as it's what the pipeline has been used for the most.

For comments and questions email

First clone the directory into wherever you'd like. Add a path variable pointing to the directory called $PCP_PATH

In order to run the pipeline simply type in the terminal -i <my_T1.nii.gz> -r precon_all

In order to customize the pipeline you'll need to create a new directory for each new animal you wish to run the pipeline in. The current example is $PCP_PATH/standards/pig

To add an animal simply mkdir $PCP_PATH/standards/<your_animal>

Once inside the $PCP_PATH/standards/<your_animal> you will need several key images and folders.

Specifically you'll need the following folders:


The extraction folder contains:

A whole head T1 template named: <your_animal>_temp.nii.gz 
A brain mask aptly named: brain_mask.nii.gz 

A brain extracted T1 template named: <animal>_brain.nii.gz

(The pipeline has only been tested for population templates. Single subject templates could also work in theory)

You'll also need a a folder titles $PCP_PATH/standards/<your_animal>/fill

The fill folder contains:

A left and right hemisphere mask named: left_hem.nii.gz right_hem.nii.gz

A subcortical structure mask named: sub_cort.nii.gz 

A brain stem and cerebellar mask named: non_cort.nii.gz 

Finally you have the option to make a segmentation priors folder titled: $PCP_PATH/standards/<your_animal>/seg_priors

This folder enables the use of tissue priors in the segmentation. We recommend using them if possible

The seg_priors folder contains:




Stay tuned for updates. We'll soon release a manual including how to generate each of the required inputs for your animal

Update! Macaque files are now included from the NMT NIMH macaque template. ** ** If using the NMT Macaque files we recommend using >80 GB memory for the FNIRT stages Also run it with a higher threshold than 0.5 ** ** Editing wm_orig.nii.gz and saving it as allows for manual corrections of the fast segmentation.

Here's the full poster explaining the pipeline:

You can’t perform that action at this time.