Linux (and Solaris)¶

These instructions apply to most Linux distributions. They apply to Solaris with little or no change.

The options, in order of preference, are:

This is the latest stable version.

 Version 1.0.5 atlas_1.0.5.tgz source code for Fokko and atlas including messages and atlas-scripts

For users who are not familiar with git, see Help with git.

Choose a directory on your machine to store the source code. Use your terminal to navigate into that directory, then type:

git clone https://github.com/jeffreyadams/atlasofliegroups.git


This creates a subdirectory “atlasofliegroups” and stores the files there.

Compiling from source¶

After you have the source code, cd to the atlasofliegroups directory.

Type:

make


You may need to edit the Makefile to change the line CXX = g++ -std=c++0x to something different, depending on your system. This is specifying the C++ compiler.

To find out your default compiler give the command:

g++ --version


The software has been well tested with g++ versions 4.8 and above, and should compile correctly with at least version 4.4.

You can choose turn on the verbose option by typing:

make verbose=true


This will show you the details of the commands your compiler is using to compile and link the codes. Some other compiler options are (you can set multiple options separated by spaces):

optimize=false
debug=true


Optimize is true by default. debug=true enables more debugging output, and allows the software to abort if certain tests fail. readline=false should only be used if you are getting error messages related to readline. See Installation – Trouble Shooting.

Ideally, this should compile the code, and produce both Fokko and atlas. If you encounter any error see see Installation – Trouble Shooting.

We recommend running:

make install


to put make atlas accessible from anywhere, and guarantee it has access to the atlas-scripts directory. By default this will put a shell script in ~/bin and points to the atlas-scripts directory. Make sure thath ~/bin is in your path. Then the commands atlas and Fokko will run the software, (and make the atlas-scripts (for atlas) and messages (for Fokko) directories available.

To install the excecutable elsewhere run:

make install BINDIR=path-to-bin-directory


See the Makefile for further options.

Alternatively, in the directory in which you built the software you can execute

./atlas –path=atlas-scripts all

The path argument tells atlas where to find the scripts, and all says to load most of the scripts (possibly excluding a few which are under development). You can also run

./Fokko

Using Docker¶

The preferred method is to compile the software from source.

The next choice is using the Docker container system.

This installs a container, which is a self-contained linux environment (similar to a virtual machine) and runs the software in the container. This is less dependent on the details of your system, and is a good option of you have trouble compiling the software yourself. It requires adminsitrative privileges, so is mainly used for personal machines, and not instutional machines under the control of a system administrator.

Install docker (community version) for your system from https://www.docker.com/community-edition

Give the command

to download the software and run it (it launches atlas and read in the fill all.at). Depending on your system you might need to log on a root, or run docker using sudo. The first time you do this it takes up to a few minutes. Subsequent times it is much faster.

If the previous two methods fail, you can download and install an executable file.

 linux 64 compiled atlas_linux_pre_1.01.tgz executable, and messages atlas-scripts directories

Extract the file:

tar xvfz atlas_linux_pre_1.01.tgz

cd to the directory:

cd atlasofliegroups

Make the file executable:

chmod u+x atlas

Run the software with the command:

./atlas  --path=atlas-scripts all


The path argument tells atlas where to find the scripts, and all says to load most of the scripts (not including a few which are under development).

Unfortunately with the precompiled software readline (command line tools) does not work. For this reason we recommend installing from source.