/CiftiLib

C++ Library for reading and writing CIFTI-2 and CIFTI-1 files

Primary LanguageC++BSD 2-Clause "Simplified" LicenseBSD-2-Clause

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.

To build it, and example executables, in the recommended "out-of-source" method using cmake:

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

#NOTE: 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 -D CMAKE_BUILD_TYPE=Release ../CiftiLib
#OR
cmake-gui ../CiftiLib

#build
make

#OPTIONAL: run tests
make test

#install library to location specified by cmake variable CMAKE_INSTALL_PREFIX
make install

#OPTIONAL: generate documentation (needs doxygen installed and on PATH)
make doc

The build results will be in subdirectories of the build directory, not in the source directory.

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.