We first need to define an environment variable for the root directory of COMPAS in your shell start-up file for COMPAS to run properly. For example, if you use bash as your shell, open ~/.bashrc with a text editor and put in the following:
where ~/codes should be replaced with the path to the directory where you cloned the COMPAS repository. For this to take effect, either restart your bash session or run:
If your shell is
zsh (which is the default of macOS 10.15), set the environment variable as above in ~/.zshrc instead of ~/.bashrc. If your shell
csh, set the environment variable in ~/.cshrc using:
setenv COMPAS_ROOT_DIR ~/codes/COMPAS
Tip: you can check whether you have correctly defined the environment variable and whether its been active by typing into your terminal the command:
This should return the directory location of the COMPAS folder (i.e. "~/codes/COMPAS").
Now go to the COMPAS source code directory:
In this directory you will find the file
Makefile, which includes the following text to inform the compiler of the location of header files, and
the linker of the location of library files, for each of the dependencies
# gsl directories GSLINCDIR := /include GSLLIBDIR := /lib # boost directories BOOSTINCDIR := /include BOOSTLIBDIR := /lib # hdf5 directories HDF5INCDIR := /usr/include/hdf5/serial HDF5LIBDIR := /usr/lib/x86_64-linux-gnu/hdf5/serial
The locations given in
Makefile may not match the locations of the files on your system.
If you installed the packages with Homebrew, the package files are likely to be found in /usr/local/opt (in directories gsl, boost, and hdf5 respectively),
but if they are not found there you will need to use Homebrew, or some other method, to locate the files. e.g. for
boost using Homebrew:
brew info boost boost: stable 1.72.0 (bottled), HEAD Collection of portable C++ source libraries https://www.boost.org/ /usr/local/Cellar/boost/1.72.0 (14,466 files, 648.5MB) * ...
Note the path, which in this case is /usr/local/Cellar/boost/1.72.0 - you will use it when you build the COMPAS executable. Repeat this for
hdf5, ensuring you locate the paths to the header files and library files.
Assuming here that the locations of the header and library files in
hdf5 are correct for your system, but the locations for
boost are not, build the COMPAS executable (compile and link) by typing:
make -f Makefile BOOSTINCDIR=/usr/local/Cellar/boost/1.72.0/include BOOSTLIBDIR=/usr/local/Cellar/boost/1.72.0/lib
The build process will run much faster if multiple processors/cores are available. To build the COMPAS executable using (e.g.) 4 cores, type:
make -j 4 -f Makefile BOOSTINCDIR=/usr/local/Cellar/boost/1.72.0/include BOOSTLIBDIR=/usr/local/Cellar/boost/1.72.0/lib
Note that both
make commands shown above will conduct incremental builds: they will only compile source files that have changed. To ensure a clean build
in which all source files are compiled, type:
make clean make -j 4 -f Makefile BOOSTINCDIR=/usr/local/Cellar/boost/1.72.0/include BOOSTLIBDIR=/usr/local/Cellar/boost/1.72.0/lib
The clean option instructs
make to remove all existing object files (.o), and the COMPAS executable. A subsequent
make is then forced to compile
all source files and link the resultant object files (and external libraries) into a new executable.
Note that rather than type the
make command each time you want to build COMPAS, you could create a file containing the
make command, and execute that
file to build COMPAS.
Once built, the executable can be tested with, e.g.:
which will display the code version.
See Building COMPAS locally for a detailed description of
A note for Mac users:
If you are using MacOS and running into linking issues with the boost libraries, try:
make clean make CPP=clang++ -j$(sysctl -n hw.ncpu)
In some Mac installations, the GNU C++ compiler is not installed how we might expect, so trying to compile and link with
clang++ might help.