These instructions will get you a copy of the project up and running on your local machine. Note that these instructions are intended for building the project from source code. If you are simply interested in running the application, have a look at the latest release instead.
To set up the repository locally, clone the repository:
git clone --recurse-submodules https://github.com/BugelNiels/nitro.git
In case --recurse-submodules
was not used, you can initialize the submodules using:
git submodule init
git submodule update
Note, if you are a developer on the project, you probably want to clone everything using ssh
instead of https
.
To do this, execute:
git config url."ssh://git@".insteadOf https://
before cloning.
Note that a plain Ubuntu docker image can be found in the docker/ directory.
Ubuntu:
- CMake
sudo apt install cmake
- Qt6
sudo apt install qt6-base-dev
- OpenCV 4
sudo apt install libopencv-dev
- OpenGL.
Should be supported by default. Might need to install
mesa-utils
sudo apt install mesa-utils
Mac:
- CMake
brew install cmake
- Qt6
brew install qt
- OpenCV 4
brew install opencv
If on Windows, good luck.
These dependencies are used by NITRO and are included as Git submodules. As such, these don't need to be manually installed.
- QtNodes
- A custom fork of the QtNodes repo. This fork was specifically created to work with NITRO.
- Qt Value Sliders
- A custom widget that allows for user-friendly control of numerical inputs. Resembles the widgets used in Blender to select numerical values.
- FLIP
- A state-of-the-art image comparison algorithm developed by NVIDIA.
To build the project, can execute the build.sh
script in the scripts/
directory and run the resulting binary:
cd scripts
bash build.sh
cd ..
./bin/nitro
Alternatively, you can manually build and run the program:
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j8
./nitro