Downloading the code¶
The code is maintained as a public Git repository on GitLab. You can access it using the
and copy the repository to your local computer by running:
$ git clone https://gitlab.com/atomicrex/atomicrex.git $ cd atomicrex
This will create a new directory named
atomicrex on your local
machine containing a copy of the atomicrex source files.
Compiling the code¶
Building atomicrex from source requires the following:
a C++ compiler and a Fortran compiler,
the CMake build system,
the xxd system tool,
several external libraries:
Python interpreter including
Python development files for compiling the atomicrex Python interface,
the Sphinx module for generating the user guide in HTML format, and
the Numpy module.
On Ubuntu Linux (tested on Ubuntu 20.04 LTS) these requirements can be readily installed by running:
# packages needed for building the code (compilers, core libraries) sudo apt install -qy \ build-essential \ cmake \ gfortran \ libboost-dev \ libboost-filesystem-dev \ xxd # packages needed for additional functionality (xml-parsing, optimization, math parser) sudo apt install -qy \ libxml2-dev \ libnlopt-dev \ libmuparser-dev # Python and Python package manager sudo apt install -qy python3-pip # Python packages python3 -m pip install \ ase \ numpy \ pyyaml \ scipy
To compile the code, create a new subdirectory, typically in the local directory created above, and invoke CMake:
$ mkdir build $ cd build $ cmake ..
If CMake succeeds in finding all the necessary libraries, it will create a Makefile. Now the compilation can be launched by running:
To build the user guide, run (this requires sphinx to be installed in addition to the packages listed above):
$ make userguide
The generated HTML files can be found in the
Manually specifying paths¶
If CMake does not succeed in finding the external libraries, it is necessary to manually configure the paths. To this end, you have different options. This can for example be accomplished by specifying parameters using the -D flag of CMake:
$ cmake -D NLOPT_INCLUDE_DIR=../path_to_success/ -D NLOPT_LIBRARY=../path_to_success/ .
Alternatively, one can invoke the interactive CMake version by executing:
$ ccmake .
Note that it is usually necessary to switch to the “advanced mode” in order to access the path settings for the libraries.
By default atomicrex is compiled as a release version, which implies that optimizations are included. If this is not desirable e.g., for debugging purposes, a debug version can be requested by running:
$ cmake -D CMAKE_BUILD_TYPE=Debug .
In this context it can also be useful to turn on verbose output during compilation, which is accomplished by running make as follows:
$ make VERBOSE=1
If supported by your C++ compiler, atomicrex automatically takes advantage of OpenMP parallelization. To explicitly deactivate this feature, the USE_OPENMP option can switched to OFF:
$ cmake -D USE_OPENMP=OFF .
In addition there are several optional features. The use of the non-linear optimization library NLopt can be disabled via ENABLE_NLOPT.
The non-linear optimization library NLopt has to be compiled as a shared library. Otherwise you might get the following error message such as .rodata.str1.1 can not be used when making a shared object / error adding symbols: Bad value. To circumvent this error compile NLopt using the –enable-shared option during the configure stage.
The Python interface functionality can be activated or deactived using the ENABLE_PYTHON_INTERFACE option.