Skip to content

Get and build source code

Alessandro Bria edited this page Sep 4, 2018 · 45 revisions

Prerequisites

  • 64-bit operating system
  • 64-bit C++ compiler
  • Qt (either 4 or 5) installed for (or built with) your C++ compiler

only needed if the WITH_GUI option is enabled (disabled by default)

  • HDF5 static libraries compiled with your C++ compiler

only needed if either the WITH_HDF5 option or any HDF5-based I/O plugin are enabled (disabled by default)

  • CMake 3.* installed on your system
  • you have read and accepted the terms and conditions stated in our LICENSE, in particular for what concerns the publications you should cite in your papers

Step-by-step procedure

  1. Clone the repository from the git shell to your designated <source> folder

    $ git clone https://github.com/abria/TeraStitcher

    or, alternatively, download the TAR ball or ZIP file and extract it to your designated <source> folder

  2. Launch CMake and set the source code directory to the <source> folder created in Step 1. Then, set your <build> folder where you want to place your C++ project and binaries (choose a folder different from <source>)

  3. Press "Configure" button and choose your desired project output (e.g. Unix Makefile, Visual Studio solution, Eclipse project) from the list.

For Visual Studio projects, please choose a "Win64"-labeled entry to enable 64-bit compilation.

  1. Press "Finish" button and CMake will check your configuration before your can generate the output project. Then, your screen should look like this (click to enlarge):



    From this screen, you can

    • include/discard I/O plugins (which are automatically discovered from the <source>/iomanager/plugins folder)
    • include/discard utilities (which are automatically discovered from the <source>/utils folder)
    • include/exclude support to HDF5 using the WITH_HDF5 option
    • include/exclude the Qt-based Graphical User Interface using the WITH_GUI option
  2. Press "Generate" button and CMake will create your output C++ project in your <build> folder.

  3. Build your generated project using your IDE (or MakeFile). Binaries will be generated in the <build>/bin folder.