0. Building

Windows

For windows, we recommend to use the latest binary available on the : https://github.com/scanberg/viamd/releases/

Linux

For Linux, we recommend you to build VIAMD on your machine following the procedure below.

Step 1: Clone the repository

(Make sure the fetch the submodules as well)

git clone --recurse-submodules https://github.com/scanberg/viamd.git

Step 2: Install dependencies

Ubuntu or kbuntu

• libx11-dev
• libxrandr-dev
• libxinerama-dev
• libxcursor-dev
• libgtk-3-dev (recommended for ubuntu, use Zenity for kubuntu)
• pkgconf
• libhdf5-serial-dev (handling of hdf5 file for VeloxChem)

Example for Ubuntu: sudo apt-get install libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libgtk-3-dev pkgconf libhdf5-serial-dev

CentOS

• mesa*
• libXrandr*
• libXext*
• libX11*
• libXi*
• libstdc++-static
• hdf5-devel (handling of hdf5 file for VeloxChem)

Example for CentOS: sudo yum libXrandr* libXext* libX11* libXi* mesa* libstdc++-static hdf5-devel

Step 3: Configure using CMAKE

https://cmake.org/ (Example using terminal and default build configuration for system)

cd viamd
mkdir build
cd build
cmake ..

To configure and enable the handling of VeloxChem files:

cd viamd
mkdir build
cd build
cmake -DVIAMD_ENABLE_VELOXCHEM=ON -DMD_ENABLE_VLX=ON ..

Step 4: Build

cmake --build .

Step 5: Run

cd bin
./viamd

Updating VIAMD

git pull --recurse-submodules

Repeat step 4 to compile!

Mac

For macOS, we recommend using the latest binary available on the release page.

NOTE: To be able to run this, you will have to do some magic in a terminal to be able to run the app bundle since we do not have code signing.

xattr -dr com.apple.quarantine viamd.app

If you want to build on Mac, follow the procedure below:

Step 1: Clone the repository

(Make sure the fetch the submodules as well)

git clone --recurse-submodules https://github.com/scanberg/viamd.git

Step 2: Install dependencies

For intel based MacOS, you will need to install the following libraries by using for instance the brew package manager.

brew install libx11
brew install libxrandr
brew install libxinerama
brew install libxcursor
brew install gtk+3
brew install pkg-config
brew install pkgconf
brew install hdf5
brew install cmake

Step 3: Configure using CMAKE

mkdir build
cd build
cmake ..

Step 4: Build

cmake --build .

Step 5: Run

cd bin
./viamd

Updating VIAMD

git pull --recurse-submodules

Repeat step 4 to compile!