The BRAINSTools is a harness to assist in building the many of the BRAINSTools under development.
Developers should run the ./Utilities/SetupForDevelopment.sh script to get started.
If developing on Mac OS X, make sure the xcode command line tools are installed with the command:
xcode-select --install
For more information on the individual BRAINSTools, please see the following link: https://github.com/BRAINSia/BRAINSTools/wiki
Linux-based system follows basically similar instruction.
clone https://github.com/BRAINSia/BRAINSTools.git
mkdir BRAINSTools_build
cd BRAINSTools_build
ccmake ../BRAINSTools
make #make -j4 or make -j8 depending on the available coresOS dependent instruction is given for any dependencies or other issues. Please report any issue you found so that we could update the instruction accordingly.
We also recommend to check out NAMICExternalProjects, https://github.com/BRAINSia/NAMICExternalProjects, which provides a set of tools, including ANTs Package, Slicer Modules, and our own BRAINSTools.
Building BRAINSTools on mac is the same as any standard out of source cmake build. Make a folder for the BRAINSTools project. Clone the BRAINSTools repository, and run the set-up script. Make a build directory contained in the same folder as the git repository. From the build directory, run cmake (or ccmake to manually configure the build settings) with the BRAINSTools repo as an argument, then run make. For Example:
mkdir brains
cd brains
git clone https://github.com/BRAINSIa/BRAINSTools.git
cd BRAINSTools
./Utilities/SetupForDevelopment.sh
cd ..
mkdir build
cd build
cmake ../BRAINSTools
## NOTE: To configure options in the cmake GUI, use:
## ccmake ../BRAINSTools
## instead
make -j${NUMOFTHREADS} -k
## NOTE: To find the number of threads from the OSX terminal, use:
## sysctl -n hw.ncpuExample session for a clean build:
mkdir ~/src/mytester
cd ~/src/mytester
git clone https://github.com/BRAINSia/BRAINSTools.git
cd BRAINSTools/
bash ./Utilities/SetupForDevelopment.sh
mkdir -p ../BRAINSTools-build
cd ../BRAINSTools-build/
CC=/usr/bin/gcc-4.2 CXX=/usr/bin/g++-4.2 ccmake ../BRAINSTools \
-DUSE_BRAINSConstellationDetector:BOOL=ON \
-DUSE_BRAINSABC:BOOL=ON
make -j${NUMOFTHREADS} -k
## NOTE: The fetching of data still has problems with parallel builds, so we need to restart it at least
# once
makeBuilding BRAINSTools on a fresh install has the additional dependency
of building CMake on your system. You cannot use the version from
apt-get as that does some unnatural things with Python resources to
be backwards compatible (see https://public.kitware.com/Bug/view.php?id=14156).
- Install the necessary dependencies:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install git python2.7
python2.7-dev g++ freeglut3-dev- Get the CMake binaries:
# You can find the URL of the latest CMake binary by
# * Go to www.cmake.org/download in a browser
# * Hover over the desired 'Binary distribution' for your operating
# system
# * Right-click and select 'Copy Link Address' for the file ending in
# "tar.gz"
URL=https://www.cmake.org/files/v3.2/cmake-3.2.1-Linux-x86_64.tar.gz
wget ${URL}
# Decompress the file
tar -xzvf cmake-3.2.1-Linux-x86_64.tar.gz
# Add the binary to your PATH environment variable
export PATH=${PWD}/cmake-3.2.1-Linux-x86_64/bin:${PATH}- Clone the repository and build:
git clone https://github.com/BRAINSia/BRAINSTools.git
mkdir build
cd build
CC=/usr/bin/gcc-4.8 \
CXX=/usr/bin/g++-4.8 \
cmake ../BRAINSTools \
make -j${NUMOFTHREADS} -klscpu
BRAINSTools_MAX_TEST_LEVEL adjusts how agressive the test suite is
so that long running tests or incomplete tests can easily be
silenced
1 - Run the absolute minimum very fast tests (These should always pass before any code commit)
3 - Run fast tests on continous builds (These need immediate attention if they begin to fail)
5 - Run moderate nightly tests (These need immediate attention if they begin to fail)
7 - Run long running extensive test that are a burden to normal development (perhaps test 1x per week)
8 - Run tests that fail due to incomplete test building, these are good ideas for test that we don't have time to make robust)
9 - Run silly tests that don't have much untility
set(BRAINSTools_MAX_TEST_LEVEL 3 CACHE STRING "Testing level for managing test burden")
The codebase should conform to clang-format defined standards that are similar to ITK's defintion.
git filter-branch -f --tree-filter \
"~/Dashboard/src/ITK/Utilities/Maintenance/clang-format.bash --clang-format ~/local/clang-format-8.0.0-macosx --tracked" HEAD..