Virtual Laboratory Environment

Version 2.1.0

A Modeling & Simulation Environment

MacOS X Installation

The installation of VLE 2.1 on MacOS requires to get and compile the source code of VLE 2.1. This process requires the use of Homebrew to install the dependencies: git, CMake, Boost and QT5. Tests are made with the Xcode application from the MacOS App Store. However, the Homebrew gcc compiler suite seems to work too.

First installation

First time you install VLE 2.1. you need to install VLE’s dependencies, get the source with Git, configure your environment the install VLE.

Install dependencies

Install Homebrew. Open Terminal and copy/paste the following line and type enter:

/usr/bin/ruby -e "$(curl -fsSL"

Then, into the same Terminal, copy/paste the following lines to install VLE’s dependencies:

brew update
brew upgrade
brew install cmake libxml2 boost pkgconfig qt5 git

If you want to use gcc instead of the Xcode application (available from the MacOS App Store), copy/paste the following line:

brew install gcc

Get and build VLE

From the $HOME/vle path, we use git to download source code of VLE and install under the $HOME/usr path:

cd $HOME
git clone git://
cd vle
mkdir build
cd build
make -j4
make install

Configure the environment

Into your $HOME/.bashrc or equivalent, write the following line (update the qt version with the correct number from Homebrew).

export CMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.9.2
export PATH=$PATH:$HOME/usr/bin:/usr/local/Cellar/qt/5.9.2/bin
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:$HOME/usr/lib/pkgconfig:/usr/local/opt/libxml2/lib/pkgconfig:/usr/local/opt/qt/lib/pkgconfig

Then into your $HOME/.bash_profile, add the following line if not present:

if [ -f $HOME/.bashrc ]
        source $HOME/.bashrc

Now, you can use vle-2.1 and gvle-2.1 from the Terminal application.

Upgrade installation

To upgrade installation, first update the Homebrew installation. In the Terminal application, copy/paste the following line et type enter:

brew update
brew upgrade

The, go into the vle source directory, update the source with git then rebuild VLE:

cd $HOME/vle
git pull -r
rm -fr build
mkdir build
cd build
make -j4
make install
Last updated on 26 Jan 2023, 09:29
Published on 13 Nov 2017, 10:47
 Edit on GitHub