Skip to content

Getting Started

Till Hofmann edited this page Oct 18, 2022 · 30 revisions

On this page, we explain how to build TACoS on a Linux system (e.g., Fedora or Ubuntu). On other systems, the commands and required packages may vary.

Dependencies

Ubuntu

To install all dependencies on Ubuntu, run:

sudo apt install build-essential cmake pkg-config  libboost-dev libboost-program-options-dev protobuf-compiler  libprotobuf-dev graphviz libgraphviz-dev libfmt-dev libspdlog-dev librange-v3-dev libtinyxml2-dev git doxygen

Fedora

To install all dependencies on Fedora, run:

sudo dnf install @development-tools gcc-c++ cmake pkgconfig boost-devel protobuf-compiler protobuf-devel graphviz-devel fmt-devel spdlog-devel range-v3-devel tinyxml2-devel git doxygen

Compiling

TACoS is a CMake-based project with a default out-of-source build. To compile the library, after cloning the repository, perform the following steps:

  1. Run cmake to configure the project:

     cmake -B build
    
  2. Build the project:

     cmake --build build -j`nproc`
    

If the compiler runs out of memory, you may want to reduce the number of parallel jobs (e.g., -j1 to run only one job at a time).

The resulting binaries and libraries will be in ./build.

Container Image

You can also download a pre-built container image from quay.io, e.g., with docker:

docker pull quay.io/morxa/tacos

You can run a shell in the container, which allows you to run the same commands as explained on Using TACoS:

docker run --rm -ti quay.io/morxa/tacos bash

You may also use alternative container runtimes such as podman.

Clone this wiki locally