Installation

Installation instructions

FORCE is mostly written in C/C++: Thus, it needs to be compiled. Administrator rights are not necessarily required, unless you want to install to the system-wide search path (e.g. to make it available to multiple users).

  1. Go to the directory, where you usually store source code, e.g.
cd ~/src
  1. Pull from Github
git clone https://github.com/davidfrantz/force.git
  1. Go to the force directory
cd force
  1. Edit the Makefile with the text editor of your choice, e.g.
vi Makefile
  • BINDIR is the directory used for installing the software.
    • By default, this is /usr/local/bin. This is a system-wide search path. If you install to this directory, all users on this machine can use the code. You need admin rights to install to this directory.
    • Alternatively, you can specify a private directory, e.g. /home/YOURNAME/bin. In this case, the code is only available to you, but you do not need admin rights for the installation.
  • The next block specifies the location of libraries and headers. It might be possible that you need to make some changes here.
  • The rest of the Makefile should be OK. Only edit anything if you know what you are doing.
  1. Compile the code
make -j
  1. Install the code. If you are installing to a system directory, include sudo to install with admin rights. If you are installing to a private directory, remove the sudo.
sudo make install
  1. Test if it was installed correctly:
force

If the program cannot be found, you will likely need to add this directory to your search path $PATH (see here). This might happen if you have used a custom installation directory.

Installation of the development version

To install FORCE with all “bleeding-edge features”, consider to use the develop version.

  • After point (3), change to the develop branch, then proceed with (4). Note that BINDIR defaults to /develop on this branch. Not installing to /usr/local/bin (which is the default for the master branch) might make sense in the case you want to have both the master and develop versions installed. You might want to change BINDIR to a directory that suits you (e.g. /usr/local/bin or a local directory).

    git checkout -b develop
    git pull origin develop
    

Installation with optional software

  • Install with SPLITS.

    Follow these steps before step 3 in the installation instruction:

    1. Install SPLITS, see Optional dependencies

    2. Enable SPLITS in FORCE

      cd ~/src/force
      ./splits.sh enable
      
    3. Proceed with the installation of FORCE

Installation in DEBUG mode

Follow these steps before step 3 in the installation instruction:

  1. Enable DEBUG in FORCE

    cd ~/src/force
    ./debug.sh enable
    
  2. Proceed with the installation of FORCE