gams-cpp is a C++ API for the General Algebraic Modeling System (GAMS). For further information about GAMS please visit GAMS or the GAMS documentation. gams-cpp uses GoogleTest which is licensed under the Revised BSD License.

• GAMS 50
• CMake 3.8
• any C++17 compiler with std::filesystem support (e.g. GCC 8, MSVC2017 15.7, Apple Clang 11)

gams-cpp 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.

Download the gams-cpp sources from GitHub (via git or as zip archive). All information about the usage of this library can be found within the GAMS C++ API documentation.

Start Qt Creator or a different IDE of your choice, open the CMakeList.txt file in the root folder and click 'Run CMake'. This generates the file 'gamsinclude.txt' that defines the default location of the GAMS installation location. The path of the 'gamsinclude.txt' file may have to be updated to the correct GAMS installation location on your system.

On Windows the file contains:

GAMS_DISTRIB=C:/GAMS/50

On Unix it will look like:

GAMS_DISTRIB=$$(HOME)/gams/gams50.0_linux_x64_64_sfx

Then perform a 'Build All' operation (Build->Build All) to build the library as well as all examples and tests. Finally, the examples can be executed by triggering Run button or pressing 'Ctrl+R'.