In order to retrieve the code from the git repository, a working git installation must be present on your computer. Depending on the operating system in use, the installation procedure for git may be different, as illustrated below.
Each Linux distribution provides a version of git in their package selection. The installation of git requires administrative rights on the system, and can be done using the following distributon-specific commands in a root terminal:
- openSUSE and SUSE Linux Enterprise:
- zypper in git-core
- Fedora and Red Hat Enterprise Linux:
- yum install git
- Debian and Ubuntu Linux:
- apt-get install git-core
Downloading the source code of a stable release
The OpenQBMM source code of the stable release of OpenQBMM can be downloaded as follows:
- Create a directory called OpenQBMM
- Go to https://github.com/OpenQBMM/OpenQBMM/releases
- Select the stable release you desire. The current stable release is 3.0.0 for OpenFOAM 5.x.
- Download the tar.gz or .zip file corresponding to the version you want to install
- Extract the content of the compressed archive you downloaded in the OpenQBMM directory
Downloading the code of the development branch
The development version of the OpenQBMM source code can be downloaded with the following commands:
- Create a directory called OpenQBMM-dev
- Open a terminal in that directory
- Use the command
- git clone https://github.com/OpenQBMM/OpenQBMM.git
- Checkout the development branch
- git checkout -b development origin/development
Due to the frequent changes in both OpenQBMM and OpenFOAM-dev, no compressed archives are made available for the development version.
Building the code
It is assumed that you have the latest stable release of OpenFOAM installed on your system. The current stable release of OpenFOAM against which OpenQBMM compiles is OpenFOAM 5.x.
Important note – Read before building the code
We track the number of times our code is built using a curl instruction to a specific URL in the main Allwmake script used to build the code. We perform this operation by invoking the curl command on a bitly URL.
The information collected in this way consists of the total number of times the URL was used, and the country of origin of the curl instruction. This information is used as a metric to know how many times our code is built for our reporting activity, as part of the metrics we adopted to establish the success of our project. We hope this is not considered an intrusive way to count the number of builds of our code, however, if you prefer your build not to be counted, please do the following:
- Open the Allwmake file in the top directory of the OpenQBMM code
- Comment out (add a # in front of) the curl command at the end of the script
Build instructions for OpenQBMM
The build process of OpenQBMM relies on the OpenFOAM build system. We assume OpenFOAM is installed and working properly on your system. If OpenFOAM is not installed on your system, please refer to the OpenFOAM documentation to install it properly.
The procedure to build the OpenQBMM solvers is the following:
- Open a terminal in the OpenQBMM directory (or OpenQBMM-dev for the development release)
- Execute: ./Allwmake
If the build is successful, no error messages will be shown, and the OpenQBMM solvers will be ready to use.