Skip to content

GAMS-dev/gams-mii

Repository files navigation

GAMS Model Instance Inspector (MII)

GAMS Model Instance Inspector (MII) is a system to examine the structure and properties of a model instance generated by the General Algebraic Modeling System (GAMS). It is strongly inspired by the tool GAMSCHK developed by Bruce McCarl. For further information about GAMS please visit GAMS or the GAMS documentation. Additional information on how to use the MII can be found at the GitHub MII Wiki.

How to build

1. Download and install Qt

The recommended way to get Qt is via its official Qt online installer. If you are interested in the Qt sources you can download them through the installer or build Qt from scratch by following the Qt documentation. Alternatively, you can get and build Qt from the official Qt GitHub mirror.

2. Download and install GAMS

The GAMS Model Instance Inspector requires the GAMS low-level APIs. All those files are provided by the GAMS distribution packages, which are available for all major platforms. The installation package for your platform can be obtained from the GAMS download page. After downloading the package please follow the latest GAMS installation instructions.

Note By default GAMS will run in demo mode. Please check the download page for further details.

3. Get the GAMS Model Instance Inspector source code

Download the GAMS Model Instance Inspector sources from GitHub (via git or as zip archive). All information about the usage of this program can be found within the GAMS Documentation.

4. Building the GAMS Model Instance Inspector project

Start Qt Creator, open the project file model-inspector.pro and click Build -> Run qmake. This generates the file gamsinclude.pri that defines the default location of the GAMS installation location. The path within the gamsinclude.pri may have to be updated to the correct GAMS installation location on your system.

On Windows the file contains:

GAMS_DISTRIB=C:/GAMS/47
GAMS_DISTRIB_C_API=$$GAMS_DISTRIB/apifiles/C/api
GAMS_DISTRIB_CPP_API=$$GAMS_DISTRIB/apifiles/C++/api

On Unix it will look like:

GAMS_DISTRIB=$$(HOME)/gams/gams47.1_linux_x64_64_sfx
GAMS_DISTRIB_C_API=$$GAMS_DISTRIB/apifiles/C/api
GAMS_DISTRIB_CPP_API=$$GAMS_DISTRIB/apifiles/C++/api

Then perform a Build All operation (Build -> Build All) to build the project. Finally, the GAMS Model Instance Inspector can be executed by triggering Run button or pressing Ctrl + R.

Contributing

Your contributions to the GAMS Model Instance Inspector project are highly appreciated! Depending on your type of improvement you may want to create an issue or fork GAMS Model Instance Inspector and open a pull request when your changes are ready.

Before you request a review of your changes please make sure that you used the latest GAMS release for development and that your code is following the Qt Coding Style.

Dependencies and Licenses

Dependency License Description
Qt 6 LGPL Qt Licensing. The Qt 6 everywhere package (source) can be downloaded from GAMS or directly from https://www.qt.io/download, where installers are provided as well.
dtoaLoc License