Before you continue, please make sure to review the license agreement: CIVET LICENSE.
If you are only interested in installing CIVET binaries only without the trouble of compiling CIVET from sources, you can obtain binaries for some common systems on the CIVET main page and CIVET release page.
At this point, the following versions are available:
- CIVET-2.1.0 - released in Oct 2016 (Ubuntu 14 and CentOS 6).
- CIVET-2.1.1 - released in Dec 2018 (Ubuntu 16, 18 and CentOS 7).
The compilation procedure is the same for all versions of CIVET.
The installation instructions described below to compile CIVET on bare-metal are long and platform-specific. The fastest way to get started is with Docker.
An image for CIVET-2.1.1 is available on Dockerhub.
docker pull mcin/civet:2.1.1# input file is a T1-weighted image
$ ls /folder
scan_00100_t1.mnc
# Run the full pipeline
$ docker run -v /folder:/data mcin/civet:2.1.1 CIVET_Processing_Pipeline -prefix scan -sourcedir /data/ -targetdir /data/ -N3-distance 200 -lsq12 -resample-surfaces -thickness tlaplace:tfs:tlink 30:20 -VBM -combine-surface -spawn -run 00100
# Use individual MINC tools
$ docker run -v /folder:/data mcin/civet:2.1.1 mincinfo /data/scan_00100_t1.mnc
file: /data/scan_00100_t1.mnc
image: signed__ short 0 to 4095
image dimensions: xspace zspace yspace
dimension name length step start
-------------- ------ ---- -----
xspace 170 1 -82.551
zspace 256 -1 102.811
yspace 256 -1 161.156git clone https://github.com/aces/CIVET_Full_Project.git
cd CIVET_Full_Project
docker build -t civet $PWD
If you really wish to continue and compile CIVET from GitHub sources, you need follow the instructions before download:
To download CIVET's "large" files (e.g. *.tar.gz, *.tgz, *.mnc, *.obj) from GIT sources, you need to install the Git Large File Storage extension. Please follow the URL (https://git-lfs.github.com/) to obtain the installation guide.
After you finish the installation, please run in your terminal:
git lfsIf the stdout is like
git lfs <command> [<args>]
Git LFS is a system for managing and versioning large files in
association with a Git repository. Instead of storing the large files
within the Git repository as blobs, Git LFS stores special "pointer
files" in the repository, while storing the actual file contents on a
Git LFS server. The contents of the large file are downloaded
automatically when needed, for example when a Git branch containing
the large file is checked out.
Your installation of Git-LFS should be successful.
As CIVET will automatically download all source code for the some acelab/BIC packages from GitHub via SSH, please make sure you can connect to GitHub with SSH.
You can test it by using
git clone [email protected]:aces/CIVET_Full_Project.gitIf it does not work, please follow Generating a new SSH key and adding it to the ssh-agent to create your SSH connection.
In this repo (CIVET_Full_Project), we include
- install.sh
- Makefile
- mk_environment.pl
- Test folder (MINC image to test CIVET)
- TGZ folder
The install.sh and Makefile will automatically download all source code for the some acelab/BIC packages from GitHub. Here is the list of acelab/BIC packages:
- arguments (forked from BIC)
- bicpl (forked from BIC)
- civet
- classify (forked from BIC)
- conglomerate (forked from BIC)
- cortex_area
- cortical_surface
- ebtks (forked from BIC)
- Getopt-Tabular
- ILT (forked from BIC)
- inormalize (forked from BIC)
- laplacian_thickness
- m4 (forked from BIC)
- minc (forked from BIC)
- mincbet
- mni_autoreg (forked from BIC)
- mni-models_adni
- mni-models_average305-lin
- mni-models_colin27-lin
- mni-models_icbm152-lin
- mni-models_icbm152-nl
- mni-modles_icbm152-nl-2009
- mni_perllib (forked from BIC)
- mni_surfreg
- mni-templates
- N3 (forked from BIC)
- oobicpl (forked from BIC)
- PMP
- pve
- ray_trace (forked from BIC)
- surface-extraction
The TGZ folder contains external packages (.tar.gz) not developed at the acelab/BIC (like HDF5, netcdf, Boost, etc). These versions in TGZ have been tested with the current version of CIVET and they work. You should not replace them with newer versions without testing and validation.
- CIVET-2.1.0 builds on older system like Ubuntu 14 and CentOS6, but it will not run unless you have an older version of PERL.
- CIVET-2.1.1 builds on newer systems like Ubuntu 16, 18 and CentOS 6, 7, using most gcc versions. This version runs with the latest version of PERL. The only notable difference between 2.1.0 and 2.1.1 is that the latter performs an intensity normalization on the t1w image prior to non-uniformity corrections, which does affect the outcome of the pipeline. We do recommend to use CIVET-2.1.1.
You can find the tag for specific version in branch drop-down menu (e.g. CIVET_2_1_1 for CIVET-2.1.1).
After you select the proper version (e.g. CIVET-2.1.1), you can down CIVET Install Script, Makefile, Externel Packages and testing images by using the following command
git lfs clone --branch CIVET_2_1_1 [email protected]:aces/CIVET_Full_Project.git
Note: Please DO NOT download the ZIP file of 'CIVET_Full_Project'! It would not download all external packages which are uploaded using LFS format.
If you have downloaded master branch of CIVET_Full_Project before, you need checkout to specific tag
git checkout CIVET_2_1_1
Before compiling, make sure that the necessary system requirements are satisfied:
- Ubuntu/Debian:
sudo apt-get install build-essential automake libtool bison
sudo apt-get install libz-dev libjpeg-dev libpng-dev libtiff-dev \
liblcms2-dev flex libx11-dev freeglut3-dev \
libxmu-dev libxi-dev libqt4-dev imagemagick gnuplot- CentOS:
yum groupinstall 'Development Tools'
yum install zlib-devel libjpeg-devel libpng-devel libtiff-devel \
lcms2-devel which cpan libX11-devel freeglut-devel \
perl-Env perl-Perl4-CoreLibs gnuplot imagemagick \
cpan install ExtUtils::MakeMakerSome of these graphical libraries may not be required, but they
have been added in the list, for completeness, if you wish to
compile the extra visualization tools.
You are now ready to compile from GIT sources. Make sure the following variables are set in the script install.sh.
ANIMAL=no
MRISIM=no
MAGICK=no
GIT=yes
CVS=no
...
make PREFIX_PATH=$INSTALL_DIR USE_GIT=$GIT USE_CVS=$CVS netpbm
make PREFIX_PATH=$INSTALL_DIR ANIMAL=$ANIMAL MRI_SIM=$MRISIM \
USE_GIT=$GIT USE_CVS=$CVS main
make PREFIX_PATH=$INSTALL_DIR ANIMAL=$ANIMAL MRI_SIM=$MRISIM \
USE_GIT=$GIT USE_CVS=$CVS civet initsNOTE: We do no provide ANIMAL support in this open-source version.
Please check whether your default terminal is bash, run
ls -lh /bin/shThe stdout should be
lrwxrwxrwx 1 root root * *** ** **** /bin/sh -> /bin/bashIf not, you have to change it to bash (DO NOT USE dash!). Use chsh or ln softlink of /bin/sh to change it.
ln -s /bin/bash /bin/shSimply run
./install.sh
- You will be first prompted to enter values for the compilation of netpbm. Choose the static build. Accept defaults for the z-library. Choose "none" for all graphics support libraries (png, jpg, X11, svga, etc).
**************************************************************
* You are about to configure netpbm for the CIVET quarantine *
* Choose all defaults options except libraries=static, *
* Svgalib=none and X11=none. *
**************************************************************
This is the Netpbm configurator. It is an interactive dialog that
helps you build the file 'Makefile.config' and prepare to build Netpbm.
Do not be put off by all the questions. Configure gives you the
opportunity to make a lot of choices, but you don't have to. If
you don't have reason to believe you're smarter than Configure,
just take the defaults (hit ENTER) and don't sweat it.
If you are considering having a program feed answers to the questions
below, please read doc/INSTALL, because that's probably the wrong thing to do.
Hit ENTER to begin.
Type gnu if you use Linux
Which of the following best describes your platform?
gnu GNU/Linux
sun Solaris or SunOS
hp HP-UX
aix AIX
win Windows/DOS (Cygwin, DJGPP, Mingw32)
tru64 Tru64
irix Irix
bsd NetBSD, BSD/OS
openbsd OpenBSD
freebsd FreeBSD
darwin Darwin or Mac OS X
amigaos Amiga
unixware Unixware
sco SCO OpenServer
beos BeOS
none none of these are even close
Platform [gnu] ==> gnu
Type regular
Do you want a regular build or a merge build?
If you don't know what this means, take the default or see doc/INSTALL
regular or merge [regular] ==> regular
Type static
Do you want libnetpbm to be statically linked or shared?
static or shared [shared] ==> static
ENTER for default option
What header file defines uint32_t, etc.?
(Doing test compiles to choose a default for you -- ignore errors)
Doing test compile: cc -c -o /tmp/netpbm0.o /tmp/netpbm0.c
'#include' argument or NONE [<inttypes.h>] ==>
Type none for libjepg
What is your JPEG (graphics format) library?
library filename or 'none' [libjpeg.so] ==> none
Type none for libtiff.so
What is your TIFF (graphics format) library?
library filename or 'none' [libtiff.so] ==> none
Type libz.so
What is your Z (compression) library?
library filename or 'none' [libz.so] ==> libz.so
ENTER for default option
Where are the interface headers for it?
Z header directory [default] ==>
Type none for libX11.so
What is your X11 (X client) library?
library filename or 'none' [libX11.so] ==> none
Type none for Svgalib
What is your Svgalib library?
library filename or 'none' [none] ==> none
ENTER for default option
What URL will you use for the main Netpbm documentation page?
This information does not get built into any programs or libraries.
It does not make anything actually install that web page.
It is just for including in legacy man pages.
Documentation URL [http://netpbm.sourceforge.net/doc/] ==>
- At the end of compilation, you should have 396 files in the Linux-x86_64/bin directory (for CIVET-2.1.1).
The install.sh script will produce the file job_test. You should run the regression test to make sure that CIVET runs properly.
./job_testOnce you are done building CIVET from sources, you can package the binaries and archive the sources:
- Package the binaries (add this line to install.sh):
make PREFIX_PATH=$INSTALL_DIR USE_GIT=$GIT USE_CVS=$CVS binaries
This will produce the output civet-2.1.1-binaries.tar.gz.
- Archive the sources (add this line to install.sh):
make PREFIX_PATH=$INSTALL_DIR USE_GIT=$GIT USE_CVS=$CVS source_packages
This will produce the output civet-2.1.1-cdrom.tar.gz.
The binaries can be copied and installed on other systems. The archive of the sources can be used to recompile based on the packages saved as .tar.gz in TGZ.
Just run in your CIVET_Full_Project folder.
cd your_CIVET_Full_Project
source Linux-x86_64/init.sh
Linux-x86_64/CIVET-2.1.1/CIVET_Processing_Pipeline
If you want to know more about the Usage of CIVET, please go to Basic Usage of CIVET, Outputs of CIVET, Quality Control