GAMS
Description
The General Algebraic Modeling System (GAMS) is a high-level modeling system for mathematical programming and optimization. It consists of a language compiler and a stable of integrated high-performance solvers. GAMS is tailored for complex, large scale modeling applications, and allows you to build large maintainable models that can be adapted quickly to new situations.
Version
- 24.2.1
Authorized Users
- Members of the gams_users group
Platforms
CIRCE
cluster- Workstation/PC
Available Solvers
- LP (Linear Programming) models:
- BARON (demo or student license)
- BDMLP (fully licensed)
- CBC (fully licensed)
- CONOPT (demo or student license)
- CPLEX (fully licensed)
- GUROBI (demo or student license)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- OSICPLEX (fully licensed)
- OSIGUROBI (fully licensed)
- OSIMOSEK (fully licensed)
- OSIXPRESS (fully licensed)
- PATHNLP (demo or student license)
- SNOPT (demo or student license)
- SOPLEX (fully licensed)
- SULUM (demo or student license)
- XA (demo or student license)
- XPRESS (demo or student license)
- MIP (Mixed-Integer Programming) models:
- BARON (demo or student license)
- BDMLP (fully licensed)
- BONMIN (fully licensed)
- BONMINH (demo or student license)
- CBC (fully licensed)
- CPLEX (fully licensed)
- GUROBI (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MOSEK (demo or student license)
- OSICPLEX (fully licensed)
- OSIGUROBI (fully licensed)
- OSIMOSEK (fully licensed)
- OSIXPRESS (fully licensed)
- SCIP (fully licensed)
- SULUM (demo or student license)
- XA (demo or student license)
- XPRESS (demo or student license)
- RMIP (Relaxed Mixed-Integer Programming) models:
- BARON (demo or student license)
- BDMLP (fully licensed)
- CBC (fully licensed)
- CONOPT (demo or student license)
- CPLEX (fully licensed)
- GUROBI (demo or student license)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- OSICPLEX (fully licensed)
- OSIGUROBI (fully licensed)
- OSIMOSEK (fully licensed)
- OSIXPRESS (fully licensed)
- PATHNLP (demo or student license)
- SNOPT (demo or student license)
- SOPLEX (fully licensed)
- SULUM (demo or student license)
- XA (demo or student license)
- XPRESS (demo or student license)**}}
- NLP (Non-Linear Programming) models:
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- MCP (Mixed Complementarity Problems) models:
- MILES (fully licensed)
- NLPEC (fully licensed)
- PATH (demo or student license)
- MPEC (Mathematical Programs with Equilibrium Constraints) models:
- KNITRO (demo or student license)
- NLPEC (fully licensed)
- RMPEC (Relaxed Mathematical Programs with Equilibrium Constraints) models:
- KNITRO (demo or student license)
- NLPEC (fully licensed)
- CNS (Constrained Nonlinear Systems) models:
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- MINOS (demo or student license)
- PATH (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- DNLP (Non-Linear Programming with Discontinuous Derivatives) models:
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- RMINLP (Relaxed Mixed-Integer Non-Linear Programming) models:
- ANTIGONE (demo or student license)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- MINLP (Mixed-Integer Non-Linear Programming) models:
- ALPHAECP (demo or student license)
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- BONMIN (fully licensed)
- BONMINH (demo or student license)
- COUENNE (fully licensed)
- DICOPT (demo or student license)
- KNITRO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- OQNLP (demo or student license)
- SBB (demo or student license)
- SCIP (fully licensed)
- QCP (Quadratically Constrained Programs) models:
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- CPLEX (fully licensed)
- GLOMIQO (demo or student license)
- GUROBI (demo or student license)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- XPRESS (demo or student license)
- MIQCP (Mixed Integer Quadratically Constrained Programs) models:
- ALPHAECP (demo or student license)
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- BONMIN (fully licensed)
- BONMINH (demo or student license)
- COUENNE (fully licensed)
- CPLEX (fully licensed)
- DICOPT (demo or student license)
- GLOMIQO (demo or student license)
- GUROBI (demo or student license)
- KNITRO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MOSEK (demo or student license)
- OQNLP (demo or student license)
- SBB (demo or student license)
- SCIP (fully licensed)
- XPRESS (demo or student license)
- RMIQCP (Relaxed Mixed Integer Quadratically Constrained Programs) models:
- ANTIGONE (demo or student license)
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- CPLEX (fully licensed)
- GLOMIQO (demo or student license)
- GUROBI (demo or student license)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
- XPRESS (demo or student license)
- EMP (Extended Mathematical Programs) models:
- JAMS (fully licensed)
- LINDO (demo or student license)
- LOGMIP (fully licensed)
- Default Solvers:
- LP: CPLEX
- MIP: CPLEX
- RMIP: CPLEX
- NLP: CONOPT
- MCP: PATH
- MPEC: NLPEC
- RMPEC: NLPEC
- CNS: CONOPT
- DNLP: CONOPT
- RMINLP: CONOPT
- MINLP: DICOPT
- QCP: CONOPT
- MIQCP: SBB
- RMIQCP: CONOPT
- EMP: JAMS
- BARON (demo or student license)
- CONOPT (demo or student license)
- COUENNE (fully licensed)
- IPOPT (fully licensed)
- IPOPTH (demo or student license)
- KNITRO (demo or student license)
- LGO (demo or student license)
- LINDO (demo or student license)
- LINDOGLOBAL (demo or student license)
- MINOS (demo or student license)
- MOSEK (demo or student license)
- MSNLP (demo or student license)
- OQNLP (demo or student license)
- PATHNLP (demo or student license)
- SCIP (fully licensed)
- SNOPT (demo or student license)
Running GAMS on Windows Workstations
Note: Off campus users must be connected to the USF VPN.
- Open Windows Explorer
- In the path bar at the top, enter \\cifs.rc.usf.edu\shares\gams_users\bin\24.2.1
- Copy one of the binary installers below to your workstation, tnen double-click it to start the installer:
- Windows 64-bit: windows_x64_64.exe
- Windows 32-bit: windows_x86_32.exe
- Once installed: launch the GAMS IDE by running gamside_win32.exe (if 32-bit OS) or gamside_win64.exe (if 64-bit OS)
- All solver executables and Matlab code is in the win32 and win64 folders at this location if needed
Running GAMS on CIRCE
The GAMS user guide is essential to understanding the application and making the most of it. The guide and this page should help you to get started with your simulations. Please refer to the Documentation section for a link to the guide.
- Note on CIRCE: Make sure to run your jobs from your $WORK directory!
- Note: Scripts are provided as examples only. Your SLURM executables, tools, and options may vary from the example below. For help on submitting jobs to the queue, see our SLURM User’s Guide.
Jobs Longer than 30 Minutes in Length
To run GAMS jobs on CIRCE, users will need to submit “batch jobs” to the scheduling environment if their jobs takes more than 30 minutes to run on a standard PC.
- The script below (for testing, name it “gams-test.sh”) can be copied into your job directory (the folder with your input files) and modified so that you can submit batch processes to the queue.
#!/bin/bash # #SBATCH --comment=gams-test #SBATCH --ntasks=1 #SBATCH --job-name=gams-test #SBATCH --output=output.%j.gams-test #SBATCH --time=01:00:00 #### SLURM 1 processor GAMS test to run for 1 hour. module purge module load apps/gams/24.2.1 gams mygams.mod
Next, you can change to your job’s directory, and run the sbatch command to submit the job:
[user@login0 ~]$ cd my/jobdir [user@login0 jobdir]$ sbatch ./gams-test.sh
- You can view the status of your job with the “squeue -u <username>” command
Jobs Shorter than 30 Minutes in Length
The GAMS IDE is not available on Linux, only command line execution is possible. If the IDE is needed for model development, run the gamside on Windows (as described above) to generate the model, then submit to the Linux cluster (as described above) to run the model.
Establishing a GUI connection to CIRCE/SC
To use GAMS, you will need to connect to CIRCE/SC with GUI redirection, either using:
- CIRCE/SC Desktop Environment
- SSH with X11 redirection
- If connecting from OSX or Linux via SSH, please ensure that you use one of the following commands to properly redirect X11:
[user@localhost ~]$ ssh -X circe.rc.usf.edu
or[user@localhost ~]$ ssh -X sc.rc.usf.edu
- If connecting from OSX or Linux via SSH, please ensure that you use one of the following commands to properly redirect X11:
Once connected to CIRCE, you can open GAMS using the steps below:
[user@login0 ~]$ module add apps/gams/24.2.1 [user@login0 ~]$ gams your_model_file
Documentation
Home Page, User Guides, and Manuals
- GAMS Home Page:
- GAMS Official Documentation:
- GAMS User-Contributed Documentation:
- ttp://www.gams.com/docs/contributed/index.htm
Benchmarks, Known Tests, Examples, Tutorials, and Other Resources
- GAMS Licensing Information
- GAMS is available on the cluster for use only to the users approved by the owner of the gams_users group. GAMS is not allowed to be installed on any workstation or laptop but is required to be run from \\ustorefiles.usf.edu\shares\gams_users\bin on Windows (as described above) and on the Linux cluster (as described above). Additional information can be obtained by sending a request using the link below
More Job Information
See the following for more detailed job submission information:
Reporting Bugs
Report bugs with GAMS to the IT Help Desk: rc-help@usf.edu