Linux (and Solaris)

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

Ways to download and install the software

The options, in order of preference, are:

Download the source code and compile it yourself

Download source code in a single file

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

Download the source code using git

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
readline=false

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

docker run -it jeffreyadams/atlasofliegroups

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.

Download and Install an executable

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.