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

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.

  1. Open Windows Explorer
  2. In the path bar at the top, enter \\cifs.rc.usf.edu\shares\gams_users\bin\24.2.1
  3. 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
  4. 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

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

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