C++ Library for reading and writing CIFTI-2 and CIFTI-1 files
C++ CMake
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cmake
example
src
.gitignore
.travis.yml
CMakeLists.txt
CiftiLib.pc.in
Doxyfile.in
LICENSE
README
USAGE
mainpage.dox

README

The CiftiLib library requires boost headers and either QT (4.8.x or 5), or libxml++ 2.17.x or newer (and its dependencies: libxml2, glib, sigc++, gtkmm and glibmm) and the boost filesystem library to compile, and optionally uses zlib if you want to use its NIfTI reading capabilities for other purposes.

It is currently set up to be compiled, along with a few simple examples, by cmake:

#start one level up from the source tree
#make build directory beside the source tree, enter it
mkdir build; cd build

#you may want to set the cmake variable CMAKE_BUILD_TYPE to Release or Debug before building
#the default build behavior may be non-optimized and without debug symbols.

#run cmake to generate makefiles
cmake ../CiftiLib -D CMAKE_BUILD_TYPE=Release
#OR
cmake-gui ../CiftiLib

#build
make

#OPTIONAL: run tests, make docs
make test
make doc

The resulting library and example executables will be in subdirectories of the build directory, not in the source directory.  You can install the library, headers, and pkg-config file (location controlled by cmake variable CMAKE_INSTALL_PREFIX) with 'make install'.

To use the installed library, use pkg-config to get the needed directories and libraries.  For instance, in cmake:

find_package(PkgConfig)
pkg_check_modules(PC_CIFTI REQUIRED CiftiLib)

You can then use cmake variables PC_CIFTI_LIBRARIES, PC_CIFTI_INCLUDE_DIRS, and similar, see here for descriptions:

https://cmake.org/cmake/help/v3.0/module/FindPkgConfig.html

Troubleshooting:

If you are using manually-installed libraries rather than distribution-packaged libraries, you may need to use the cmake variables CMAKE_LIBRARY_PATH and CMAKE_INCLUDE_PATH.

If you are getting link errors related to boost, try setting a cmake variable Boost_NO_BOOST_CMAKE to true.