--------------------
Building (Unix-like)
--------------------

The programs in this Hex package can be built by simple "make" command,
provided that the three Makefiles are appropriately edited if the dependent libraries
are in non-system locations.

> cd hex-db   ; make ; cd ..
> cd hex-dwba ; make ; cd ..
> cd hex-ecs  ; make ; cd ..

The following configuration successfully builds and runs the package:

Compiler:
    GCC 5.3.0 (also MinGW-w64 based on this GCC)
    LLVM/clang 3.7.1
    Intel C++ Composer XE 16.0

Third-party libraries:
    GSL 2.1
    OpenBLAS 0.2.15
    UMFPACK 5.7.4           (part of SuiteSparse 4.5.1)
    sqlitepp 0.2            (included in libs/, works e.g. with sqlite3 3.15.0)
    CLN 1.3.4
    GiNaC 1.6.7

MPI (optional)
    OpenMPI 1.8.3
    Microsoft MPI v7
    
Other optional dependencies:
    png++ 0.2.5             (included in libs/, works e.g. with libpng 1.6.6)
    OpenCL 2.1
    SuperLU 5.0             (not recommended due to high memory requirements)
    
Code documentation generation:
    Doxygen 1.8.5

The libraries can be downloaded from the SourceForge page of the Hex project:

           https://sourceforge.net/projects/hecs

-----------------------
Building (Windows-like)
-----------------------

It is possible to download Windows binaries at the SourceForge web page for both
the Hex programs and the required libraries. Also, the libraries are rearranged
to Code::Blocks projects, so that they can be easily rebuild. However, the authors
do not recommend using Hex in Windows; the compilation is still quite cumbersome
and the performance is not very great.

Hex for Windows requires Microsoft MPI to be installed.

-------
Running
-------

Three variants of the test run are located in "./hex-ecs/test-run". They all assume
that the programs "hex-ecs" and "hex-db" are in executable PATH. See "./hex-ecs/README.txt"
for more information.
