gams-dev/gams-cpp

GAMS C++ API

gams-cpp's Issues

Supporting WebAssembly

Hey there!
First off, thanks for your amazing work on the C++ API and GAMS in general!

In the past, we had several issues with reading GDX containers through the higher level APIs (mostly gdxrrw and a missing link to a GAMS installation in R).
As all of these issues were related to software setup (no actual GAMS/GAMS API issues), we had a further look into container solutions (e.g. docker). However, especially when working with students or project partners not too familiar with the matter, setting up theses containers is still cumbersome.

As a possible solution, I was thinking about creating a WebAssembly module for reading GDX containers. In my opinion, there are many benefits from being able to read GDX containers in browsers. It would a very portable solution, and would not require any installation for users who would just like to explore model results or do follow up statistics despite not being modelers themselves. Also, I guess the GAMS MIRO project could benefit from a WebAssembly GDX module as well.

As a start, I tried to compile the xp_example1 to WebAssembly using emscripten. However, as stated in the README of this repo, the C++ API requires the low level APIs provided by the GAMS distribution packages. As these require some dynamic linked libraries (being unsupported by WebAssembly), the conversion failed.

My knowledge about the matter is absolutely limited, so excuse me if any of the questions are stupid:
a) would it be possible to replace the linked libraries with their "original, non-machine code", or is there any other alternative that you know of that I could use?
b) do you have any plans for porting the library to WebAssembly in general?

Best
Christoph

Finalize Transport13

Review API documentation

Review the API documentation to finanlize the wording, code samples, doxygen tags and fix possible typos.

• GAMSWorkspacePool
• GAMSWorkspaceInfo
• GAMSWorkspace
• GAMSDatabase
• GAMSDatabaseIter
• GAMSDomain
• GAMSDatabaseDomainViolation
• GAMSJob
• GAMSCheckpoint
• GAMSModelInstance
• GAMSModelInstanceOpt
• GAMSModifier
• GAMSSymbol
• GAMSSymbolIter
• GAMSSet
• GAMSSParameter
• GAMSVariable
• GAMSEquation
• GAMSSymbolRecord
• GAMSSymbolDomainViolation
• GAMSSetRecord
• GAMSParameterRecord
• GAMSEquationRecord
• GAMSVariableRecord
• GAMSException
• GAMSExceptionExecution
• GAMSOptions
• GAMSEnum
• GAMSLog
• GAMSPlatform
• GAMSVersion
• SolverOptions
• GAMSPath