Installation

MUSCOD is delivered as Python package named moba_muscod. Currently it is available for Windows (Python 3.7 64-bit) and Linux (Python 2.7 64-bit). In the following the installation is described.

Windows

In the following the installation for Windows is described.

Python

We recommend installing the latest Python distribution of Ananconda3 (64-bit version). Please select “Add Anaconda to my PATH environment variable” during the installation. MUSCOD has a few dependencies to common Python packages. Most of these Python packages are already included, if you install Anaconda with standard configuration. As MUSCOD requires Python 3.7 and the lastest distribution of Anaconda is shipped with a newer version of Python, Python 3.7 has to be installed manually:

  1. Run a shell as administrator
  2. Run the command conda create -n py37 anaconda python=3.7 to install the Python 3.7 environment
  3. Run the command conda activate py37 to activate the Python 3.7 environment named py37
  4. Run the command conda install -c conda-forge fmpy to install the python package fmpy

Please make sure the Python 3.7 environment remains selected as MUSCOD won’t run with any other environment.

MinGW-w64

Python is only used as user interface for MUSCOD, the actual numerical optimization part is written in C++. Each new application has to be compiled and linked to the solver. You must have the free gcc compiler installed, which is included in MinGW-w64.

Open the link and download and run the file MinGW-W64-install.exe. After starting the installtaion you will be asked to specify the setup settings. They have to be specified as follows:

  • Version: 8.1.0
  • Architecture: x86_64
  • Threads: win32
  • Exception: seh
  • Build revision: 0

By default, the path to the bin directory of MinGW-w64 should be added to the environment variable Path. If the bin directory is not listed here (as “C:\Program Files\mingw-w64\x86_64-8.1.0-win32-seh-rt_v6-rev0\mingw64\bin”), please add it manually.

If the installer is not working, please download the file x86_64-win32-seh (version: MinGW-W64 GCC-8.1.0). Unzip the file. Save the folder mingw64 in “C:\Program Files\mingw-w64\x86_64-8.1.0-win32-seh-rt_v6-rev0”. Add the bin directory to the environment variable Path as described above.

MUSCOD

Save the unziped folder moba_muscod in a place where you have write permissions (e.g. “C:\Program Files (x86)\MUSCOD\moba_muscod”). Open the environment variable “PYTHONPATH” then and add the path to moba_muscod (e.g. “C:\Program Files (x86)\MUSCOD"). The environment variable “PYTHONPATH” should have been created during the installaion of Ananconda3. If not, please add it manually.

Please restart your computer after finishing the installations.

Linux

In the following the installation for Linux is described.

Python

The 64-bit version of Python 2.7 has to be installed on you system. Make sure that the following packages are installed:

  • numpy
  • pandas
  • openpyxl
  • scipy
  • matplotlib
  • fmpy

Environment variables

Save the unziped folder moba_muscod in a place where you have write permissions (“directory/moba_muscod”). After that modify the following environment variables:

  • Add “directory/moba_muscod/muscod/linux/bin” to LD_LIBRARY_PATH
  • Add “directory” to PYTHONPATH

Libraries

Install the following libraries:

  • libblas3
  • liblapack3
  • libgfortran4