Compiling Instructions

WINDOWS

Prerequisites

GUI-Build

  1. Clone the GitHub repository.

  2. Run CMake and choose a source and the build folder for Autoscoper and click configure.

  3. On Windows choose a 64bit build of the Visual Studio version you have installed.

  4. Dependencies to tiff and glew will be installed automatically and the other dependencies should be found automatically.

  5. By default it will use CUDA.

  6. You receive an error for Qt5_DIR. Select the following path $QT_ROOT_PATH\msvc2017_64\lib\CMake\Qt5 (e.g., C:\Qt5\5.10.1\msvc2017_64\lib\cmake\Qt5).

  7. Click configure again.

  8. Click generate

  9. Click open project and build in Visual Studio.

  10. To install build the INSTALL project in VisualStudio. This will build Autoscoper and installs it in your build folder in the sub-folder install/bin/Debug or install/bin/Release depending on which build was performed.

NOTE: Debugging a CUDA program is not straightforward in Visual Studio, so you cannot do the debugging similar to other applications.

Cli-Build (Using Powershell)

  1. Clone the GitHub repository.

  2. Enter the repos directory

  3. Make and enter a build directory mkdir build and cd build

  4. Configure project cmake .. -DAutoscoper_SUPERBUILD=ON -DAutoscoper_RENDERING_BACKEND="CUDA"/"OpenCL" -DQt5_DIR="path/to/Qt5Config.cmake"

  5. Build external dependencies cmake --build . --config Release/Debug

Optionally Install the project:

  1. Install project cmake --build Autoscoper-build --target install --config Release/Debug

  2. The autoscoper.exe will be in the folder build/install/bin/Debug or build/install/bin/Release depending on which build was performed.

GNU/Linux systems

  1. Clone the GitHub repository.

  2. Create a build folder in the autoscoper folder and run ‘ccmake ../.’ from the build folder (configure and generate)

  3. Build using ‘make’ in the build folder.

NOTE for HPC SERVERs: You need to use VNC or another application that gives you a display access. Autoscoper will not run if your HPC server does not have display and GPU access.

MAC OS - CUDA Only

These instructions are untested and maybe obsolete.

  1. Clone the GitHub repository.

  2. Create a build folder in the autoscoper folder, open CMake and use XCode as compiler.

  3. When receive an error, modify the fields:

  4. CMAKE_OSX_ARCHITECTURES recommended to set to x86_64

  5. CMAKE_OSX_DEPLOYMENT_TARGET to 10.15 (or your mac_os version)

  6. If received an error for Qt5_DIR, search for (Qt5Config.cmake) on your hard drive and write its location in the field.

  7. After generating the configured file, open XCode and compile the application

Docker Image

  1. Clone the GitHub repository

  2. Install Docker

  3. If running Windows Subsystem for Linux (WSL), install VcXsrv Windows X Server for GUI passthrough.

  4. Open a terminal and navigate to the docker subfolder of the repository

  5. Run docker build -t "autoscoper_dev_ubuntu:latest" -f ./UbuntuDockerFile .

  6. Find your IP address (using ipconfig on Windows or ifconfig on Unix)

  7. Run docker run --rm -it --gpus all -e DISPLAY=<IP>:0.0 --name autoscoper_ubuntu autoscoper_dev_ubuntu:latest