Unwind is a tool for unwarping bent volumetric scans of fishes. This repository contains the source code for the Unwind Paper,
Executables for Unwind are available for Windows.
Packages for Linux will be made available soon. For now, you can compile Unwind from source (see below)
Detailed instructions for using Unwind are available here
Unwind requires minimal dependencies and can be easily compiled from source.
To build Unwind you need to have the following dependencies installed:
- A modern C++ compiler (C++ 14 or later) such as GCC or Clang
- CMake version 3.8 or later
- Qt5
- Xorg development libraries (Needed by GLFW)
You can install the necessary packages on ubuntu as follows:
sudo apt-get install build-essential cmake xorg-dev qt5-default
Once you have installed the dependencies, simply clone this repository:
git clone https://github.com/fwilliams/unwind
cd unwind
Then, from the root directory of the repository run:
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j4
The binary for Unwind will be in build/src/unwind
relative to the root of the repository.
From Powershell, run:
git clone https://github.com/fwilliams/unwind
cd unwind
To build Unwind on Windows, you need to install the following dependencies:
- vcpkg: Install using instructions at https://github.com/Microsoft/vcpkg
- Qt5: Download the installer https://www.qt.io/offline-installers
- CMake: Dowload and run the installer: https://cmake.org/download/
- Boost: From the vcpkg directory, run:
.\vcpkg.exe --triplet x64-windows install mpir mpfr boost
Using Powershell, from the root directory of the Unwind repository, first create a build directory:
mkdir build
cd build
then generate a visual studio project:
cmake -G 'Visual Studio 15 2017 Win64' -DCMAKE_PREFIX_PATH="C:/Qt/Qt5.10.1/5.10.1/msvc2017_64" -DMPFR_INCLUDE_DIR:PATH="C:/local/vcpkg/installed/x64-windows/include" -DMPFR_LIBRARIES:FILEPATH="C:/local/vcpkg/installed/x64-windows/lib/mpfr.lib" -DGMP_INCLUDE_DIR:PATH="C:/local/vcpkg/installed/x64-windows/include" -DGMP_LIBRARIES:FILEPATH="C:/local/vcpkg/installed/x64-windows/lib/mpir.lib" -DBOOST_ROOT="C:/local/vcpkg/installed/x64-windows" ../
NOTE: The above commands assumes that Qt 5.10.1 is installed in C:\Qt, and vcpkg in C:\local\vcpkg. The paths need to be updated according to where these are installed (and version of Qt installed).
The previous step generates a fish_deformation.sln
file in the build
directory creaated in step 3
Open this file using Visual Studio and build the project (making sure that the "Solution configuration" is release and "Solution platform" is x64