Compiling Instructions
WINDOWS
Prerequisites
Qt5: Download Qt universal installer and install Qt 5.15.2 components.
Update your graphics card driver.
GUI-Build
Clone the GitHub repository.
Run CMake and choose a source and the build folder for Autoscoper and click configure.
On Windows choose a 64bit build of the Visual Studio version you have installed.
Dependencies to tiff and glew will be installed automatically and the other dependencies should be found automatically.
By default it will use CUDA.
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).
Click configure again.
Click generate
Click open project and build in Visual Studio.
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)
Clone the GitHub repository.
Enter the repos directory
Make and enter a build directory
mkdir build
andcd build
Configure project
cmake .. -DAutoscoper_SUPERBUILD=ON -DAutoscoper_RENDERING_BACKEND="CUDA"/"OpenCL" -DQt5_DIR="path/to/Qt5Config.cmake"
Build external dependencies
cmake --build . --config Release/Debug
Optionally Install the project:
Install project
cmake --build Autoscoper-build --target install --config Release/Debug
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
Clone the GitHub repository.
Create a build folder in the autoscoper folder and run ‘ccmake ../.’ from the build folder (configure and generate)
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.
Clone the GitHub repository.
Create a build folder in the autoscoper folder, open CMake and use XCode as compiler.
When receive an error, modify the fields:
CMAKE_OSX_ARCHITECTURES recommended to set to x86_64
CMAKE_OSX_DEPLOYMENT_TARGET to 10.15 (or your mac_os version)
If received an error for Qt5_DIR, search for (Qt5Config.cmake) on your hard drive and write its location in the field.
After generating the configured file, open XCode and compile the application
Docker Image
Clone the GitHub repository
Install Docker
If running Windows Subsystem for Linux (WSL), install VcXsrv Windows X Server for GUI passthrough.
Open a terminal and navigate to the docker subfolder of the repository
Run
docker build -t "autoscoper_dev_ubuntu:latest" -f ./UbuntuDockerFile .
Find your IP address (using
ipconfig
on Windows orifconfig
on Unix)Run
docker run --rm -it --gpus all -e DISPLAY=<IP>:0.0 --name autoscoper_ubuntu autoscoper_dev_ubuntu:latest