Download & installation

Install GAMS MIRO Desktop

Note:

To be able to solve models in GAMS MIRO, GAMS 30.2 or later is required. You can download the latest GAMS version here.

GAMS MIRO Desktop itself is open source software. In order for GAMS to interact with MIRO, the MIRO connector is required, which is included in the GAMS system from GAMS version 30.2. Without a valid license, the connector has limitations on the number of indexed symbols that can be communicated with MIRO. A maximum of 10 indexed symbols can be included in $on/offExternalInput and $on/offExternalOutput.

Please check the release notes.

By downloading this software, you agree to the License Agreement.

Installation

To install GAMS MIRO and its components, download the latest version and run the setup, which will guide you through the installation process. Make sure that no MIRO application is running during this time.

By downloading this software, you agree to the License Agreement.

Note:

GAMS MIRO is currently not supported on the new Apple Silicon processors.

Installation

To install GAMS MIRO and its components, download the latest version.

By downloading this software, you agree to the License Agreement.

Installation

  1. In case a current R version (3.6 or later) is not yet installed on your system, you need to do this first. You can download R here.
  2. For MIRO to work, the system libraries V8 and libcurl need to be installed. On Debian / Ubuntu you need libcurl4-gnutls-dev and either libv8-dev or libnode-dev, on Fedora use libcurl-devel and v8-devel. For example, to install both libraries on Ubuntu, run:
    > sudo apt install libcurl4-gnutls-dev libv8-dev
  3. The first time you launch the GAMS MIRO AppImage, some R packages need to be installed. They are installed either at the R installation path: rPath/miro-library or in the user's home directory ($XDG_CONFIG_HOME/miro-library or ~/.config/miro-library) depending on whether MIRO was installed for all users or only for the current user. You will be guided through this installation process.

GAMS MIRO workspace

The workspace is the place where deployed apps are stored and cached, Hypercube jobs are executed and logs are written. The MIRO database with all user scenarios is also located there. Furthermore all user settings and additional R packages are kept in the workspace.

On all platforms, the MIRO workspace is located at ~/.miro. On MacOS and Linux, ~ is resolved to: $HOME, on Windows to %USERPROFILE%.

Uninstall GAMS MIRO

To uninstall the software, please follow the default procedure of your operating system. The uninstaller only deletes the data in the directory where GAMS MIRO was installed. On Windows you will be asked if you also want to permanently delete the MIRO database with all your settings. This refers to data in the MIRO workspace. If you agree, the entire directory will be deleted. On both MacOS and Linux systems, the MIRO workspace is not deleted. To remove the data permanently, you have to do this manually.

Demo applications

We provide some GAMS MIRO demo applications. You can use these to get to know some of MIRO's basic features. To run the sample applications, you must first extract them. More about this here.

Note:

A well-known model from the GAMS model library is called trnsport. One of the MIRO demo models is based on this model and has been titled transport to avoid two models of the same name.