-
Notifications
You must be signed in to change notification settings - Fork 23
Build Instructions: General
The IBIS platform is currently maintained for Linux Mint 22, macOS 13.7.5 and Windows 11. Other Ubuntu 24.04 variants would likely work as well. It may also work on older or newer OS versions (and possibly other platforms) as it relies only on cross-platform libraries, but is untested and support cannot be provided for them.
IBIS requires installation of the following dependencies before building:
- git
- CMake (minimum version 3.12)
- OpenCL (see platform-specific instructions for details)
- Qt (currently tested with 6.4.2)
A manual on how to install OpenCL on Windows can be found here. Additionally, make sure to restart the computer so that OpenCL is recognized by the system.
Other dependencies can be downloaded from the above links. On Windows, IBIS additionally requires a C++ compiler such as Microsoft Visual Studio 2022.
On Linux Mint, all required dependencies can be installed by running the following command:
> sudo apt-get install git cmake g++ libxt-dev libglvnd-dev ocl-icd-libopencl1 ocl-icd-opencl-dev opencl-headers nvidia-cuda-dev qt6-base-dev
Optionally, you can also install package cmake-qt-gui to facilitate configuration.
The only required dependency on macOS is Qt. The simplest way to get Qt is to download the latest online installer from their website.
These instruction assume you are compiling IBIS in a folder called <basedir>. We will put source code in <basedir>/src and build in <basedir>/build.
> mkdir <basedir>
> cd <basedir>
> git clone https://github.com/IbisNeuronav/Ibis.git src
For every official release of IBIS, a branch called release-x.y is created where x.y is the version of the release. To get the code for a particular release, do the following:
> cd src
> git checkout release-x.y
The easiest way to build IBIS from scratch is to use the SuperBuild mechanism which will build IBIS and will also download and build all of the dependencies in the proper version and with required compilation flags. To run the SuperBuild, type this:
> mkdir <basedir>/build
> cd <basedir>/build
> cmake <basedir>/src/IbisSuperBuild
You may find detailed instructions in the Build instructions Windows 11.
If Qt isn't installed through system packages, the path to Qt will need to be provided to CMake either through the command line flag -DQt6_DIR=</path/to/Qt/<VERSION_NUMBER>/lib/cmake/Qt6> or by setting the Qt6_DIR option in the gui.
Once CMake succeeds just make:
> make
The jobs option can also be set to accelerate the build process through parallel processing. For instance on an 8-core machine, the build command would be make -j8.
You may find detailed instructions in the Build Instructions macOS.