43分发

文档

• 文档的PDF版本将在未来版本中删除。

嵌入式代码设施

• 对中断信号作出反应（例如，从Ctrl-C）。如果接收到中断信号，则执行被中断并且发出编译或执行错误。
• 设置gams.debug只影响GamsWorkspace的调试行为，因为异常追溯现在总是启用的。
• 修复异常追溯被写入stdout而不是GAMS日志。
• 修正了异常追溯中的错误行号。

GAMS连接

• 已为未处理的Python异常启用异常追溯。
• Options 代理的Debug选项已弃用，将在将来的版本中删除。使用Options代理与 trace > 0来获取Connect错误的异常追溯。
• 修复异常追溯被写入stdout而不是GAMS日志。
• 添加RawCSVReader代理到Connect。
• 更新了RawExcelReader中的长标签重命名逻辑，以便仅在必要时增加后缀编号~n。
• 在pandas版本1.5.0中，mad聚合方法已被弃用，因此在未来版本中将无法用于Projection代理。
• Concatenate代理现在支持多次串接相同的符号。
• SQLReader和SQLWriter代理（以前的PandasSQLReader和PandasSQLWriter）已经过修订，现在支持本机SQL连接，以实现更快的读/写操作。两个代理现在都通过各自的python包连接到MySQL，Postgres，MS-SQL（SQL-Server），SQLite和PyODBC。pandas.DataFrame类的I/O API方法read_sql和to_sql可以与connectionType sqlalchemy结合使用，并且如果系统上存在相关驱动程序，则允许连接到任何其他数据库。
• SQLWriter代理支持writeAll。如果是True，Connect数据库中的所有符号（集合和参数）将被写入指定的数据库。

GMSPython

• 添加了软件包pymssql和pymysql。对于ARM64 CPU上的macOS，已添加额外的包freetds作为pymssql的依赖项。

求解器

ANTIGONE、CBC、Ipopt、SCIP、SHOT

• 适用于x86_64的Linux和macOS上的新库Intel MKL 2023.1。

CBC

• 新库Cbc 2.10.10、Cgl 0.60.7、Clp 1.17.8、CoinUtils 2.11.8。
  • 对称处理的扩展。
  • OrbitalBranching选项的新值fastish、lightweight、moreprinting、cuts和cutslight。
• 新库nauty 2.8.6.
• 如前所述，CBC别名COINCBC已被删除。

CONOPT

• 正如所宣布的，CONOPT3别名CONOPTD已经被删除。

CONVERT

• 现在AMPL.nl编写器也可以编写方程边缘值。
• 添加选项 AmplNlInitDual 和 AmplNlInitPrimal的 指定要写入AMPL.nl文件的等式边际值和变量值。
• 如前所述，CONVERT别名CONVERTD已被删除。

COPT

• 新库 6.5.2.
  • 增强了对特殊有序集和指示符约束的支持。
• 增加了写入solve trace文件。新选项solvetrace, solvetracenodefreq, 和solvetracetimefreq。

CPLEX和OSICPLEX

• GAMS/CPLEX现在可用于求解LP和MIP，无需GAMS/CPLEX或GAMS/CPLEX Link许可证，但需要OSICPLEX许可证。因此，它类似于GAMS/CPLEX Link许可证，但仅限于（混合整数）线性问题。若要使用测距、冲突分析、feasopt、调整、列生成、解池、惰性约束、二次约束、指示器约束、线性用户切割、多目标优化、优先级、折弯机分解或用户回调，仍需要GAMS/CPLEX或GAMS/CPLEX Link许可证。
• GAMS/OSICPLEX现在是GAMS/CPLEX的别名。别名GAMS/OSICPLEX将在未来的主要版本中删除。GAMS/CPLEX无法处理以前的GAMS/OSICPLEX选项文件。
• 正如所宣布的，CPLEX别名CPLEXD已经被删除。

DE

• 引入了一个实验性的隐藏选项deDict来生成一个文本文件，其中包含所生成的确定性等价物的字典类型信息。

DECIS

• 如前宣布，EMP-SP求解器DECIS已被删除。这不会影响随机LP求解器 Decisc 和 Decism.它们仍然在系统中。

Examiner

• Examiner现在具有SolveLink =5的能力。进行了一些外观输出更改。

GUROBI和OSIGUROBI

• 新库10.0.1.
• 如果机器上安装了单独的GUROBI许可证，GAMS/GUROBI现在可以用于解决LP和MIP，而无需GAMS/GUROBI或GAMS/GUROBI Link许可证。因此，它类似于GAMS/GUROBI Link许可证，但仅限于（混合整数）线性问题。要使用二次约束、指示器约束、一般或非线性约束、惰性约束、多目标优化、多个MIP启动、分区、MIP停止表达式、解池、feasopt、iis、灵敏度分析或调整，仍然需要GAMS/GUROBI或GAMS/GUROBI Link许可证。
• GAMS/OSIGUROBI现在是GAMS/GUROBI的别名。在未来的主要版本中，别名GAMS/OSIGUROBI将被删除。

IPOPT

• 正如所宣布的，IPOPT别名COINIPOPT已被删除。
• 新库 3.14.12.
  • 修正了一个平方问题，对偶解有时不满足最优性条件，即使问题被声称最优求解。

KESTREL

• 移除了对已停产的IBM DOcloud的访问。

LINDO/LINDOGLOBAL

• 新库 14.0.255.

MILES

• 正如所宣布的，MILES别名MILESE已被删除。

MINOS

• 正如所宣布的，MINOS别名MINOS5和MINOS55已经被删除。

MOSEK 和 OSIMOSEK

• 如果在机器上安装了单独的MOSEK许可证，GAMS/MOSEK现在可以用于解决LPs和MIPs，而无需GAMS/MOSEK或GAMS/MOSEK Link许可证。因此，它类似于GAMS/MOSEK Link许可证，但仅限于(混合整数)线性问题。要使用二阶、半定、幂或指数锥，仍然需要 GAMS/MOSEK 或 GAMS/MOSEK Link许可证。
• GAMS/OSIMOSEK现在是GAMS/MOSEK的别名。在未来的主要版本中，别名GAMS/OSIMOSEK将被删除。
• 在大多数情况下，GAMS/MOSEK和GAMS/OSIMOSEK的作用相当。主要区别是:
  • MIP求解之后是LP求解，默认情况下所有离散变量都是固定的。使用选项SOLVEFINAL将其禁用。
  • 设置GAMS选项integer2不再允许将实例写入文件。请改为设置选项MSK_SPAR_DATA_FILE_NAME。

Octeract

• 新库 4.7.1.

ODHCPLEX

• 新库7.07.
  • 新选项addcuts:从CPLEX主解算添加切割的指示器。
  • 新选项firstfeaslpitlim:在第一个可行的启发式算法中限制宽松的重解次数。
  • 新选项firstfeasrelaxcrit:使用宽松求解时不可行性/行的最小总和。
  • 新选项ignoresetslvrparams:控制ODH是否可以动态改变规划求解参数的标志。
  • 新选项keypartition:求解器分区信息的使用。
  • 新选项keysminimum:自动分解方法试图找到的键的最小数量。
  • 新选项localsearch:本地搜索启发式的指示器。
  • 新选项loosefeastol:宽松可行性容差。
  • 新选项objthreshold:客观系数绝对值的阈值。
  • 新选项sosfind:自动检测特殊有序集(SOSs)。
  • 新选项sosinkey:将每个SOS分配给它自己的子模型组件(key)。
  • 新选项sosmember:自动检测变量成员名与此模式匹配的SOS。
  • 新选项sosovar:自动检测输出变量名与此模式匹配的SOSs。
  • 新选项sosselect:选择SOS成员的子集。
  • 新选项sosselect16: 仅为16个或更少成员的集合选择SOS成员子集。
  • 新选项soswvar：自动检测输入（权重）变量名称与此模式匹配的SOS。
  • 新选项strictdeterministic：当改进启发式算法完成时，确定性地终止ODH。
  • 新选项subcheckfreq：子模型LP被中断用于相互通信的频率。
  • 新选项tightenprebounds：ODH预解模型中的绑定收紧级别。
  • 新选项trialbound：试探边界启发式。
  • 新选项trialboundfile：试用绑定文件。
  • 新选项trialboundsetsize：自动生成的试验绑定集的大小调整。
  • 新选项usehistory：在当前选择中使用过去的子模型选择。
  • 新选项varcleanlpmethod：用于求解可变清除LP的方法。
  • 将选项interdiv的下限更改为1。
  • 删除了选项seed的下限。将默认值更改为12345。
  • 将选项feastol的下限更改为0，上限更改为1。
  • 将选项subnodelimit的下限更改为-2。
  • 将选项divisor的下限更改为2，默认值更改为4。
  • 将选项decompdensity 的上限更改为1。
  • 将选项firstfeascontinue的上限更改为2。将选项类型更改为整数。
  • 将选项firstfeasshift的默认值更改为0。
  • 将recurseminiterlim选项的默认值更改为10。
  • 将选项variableclean的默认值更改为1。
  • 删除选项newcallback。
  • 删除选项odhpresolve。
  • 删除选项subpresolve。

PATH

• PATH别名PATHC已删除。

SCIP

• 新库bliss 0.77.
• 正如所宣布的，SCIP别名COINSCIP已被删除。

SOPLEX

• 正如所宣布的，SOPLEX别名OSISOPLEX已经被删除。

XPRESS和OSIXPRESS

• 新库41.01.03.
• 如果计算机上安装了单独的XPRESS许可证，则GAMS/XPRESS现在可以用于解决LP和MIP，而无需GAMS/XPRESS或GAMS/XPRESS Link许可证。因此，它类似于GAMS/XPRESS Link许可证，但仅限于（混合整数）线性问题。要使用二次约束、非线性约束、指示器约束、优先级、MIP跟踪、解池，仍需要GAMS/XPRESS或GAMS/XPRESS Link许可证。
• GAMS/OSIXPRESS现在是GAMS/XPRESS的别名。别名GAMS/OSIXPRESS将在未来的主要版本中删除。

工具

$LibInclude文件

• libinclude文件gdxservice、linalg和win32已弃用，并将在未来版本中删除。请使用更灵活方便的GAMS工具库中的相应工具。

CHK4UPD

• 正如所宣布的，命令行工具CHK4UPD已经被删除。该工具的功能仍然可以通过GAMS Studio获取。

CSDP

• 如前所述，csdp工具已经被放弃了。可以用GAMS/MOSEK来代替。

GAMS Studio

• 新版本 1.14.2.
  • 改进了项目的命令行参数处理:
    • 添加了参数文件编辑器。
    • 将“Add new GAMS Parameter File”添加到Project Explorer上下文菜单中。
    • 在Project Settings中增加了主文件和参数文件的选择。
  • 增加了GAMS引擎令牌授权。
  • 添加了GDX查看器设置，以控制复制数据时使用的小数分隔符。
  • 在参考文件查看器中添加了“File Used”部分。

GAMS工具库

• GAMS工具库是一个工具的集合，提供了一个复杂任务的简单访问。随着时间的推移，传统的工具集将被GAMS工具库中的GAMS连接代理和工具所取代。在一段时间内，两种方式都将被支持，但可执行工具将消失，所以当您不确定选择什么工具时，选择Connect或GAMS工具库中的工具。
• GAMS工具库目前包括带有Rank的alg、带有ExcelDump的data、带有GDXEncoding和GDXRename的gdxservice、带有Cholesky、特征值、特征向量、反转和ols(普通最小二乘法)的linalg，以及带有ExcelMerge、ExcelTalk、MSAppAvail和ShellExecute的win32。
• 在GAMS程序中，可以通过$callTool(编译时)和executeTool或put _ utility ' execute tool '(执行时)调用GAMS工具库中的工具。
• 在shell/命令提示符下，脚本gamstool可用于运行GAMS工具库中的工具。

GDXTROLL

• 如前所述，gdxtroll工具已被弃用。

MPS2GMS

• MPS2GMS现在可以被指示为LP文件的目标或约束中的同一项添加或忽略多个系数。请参见MPS2GMS文档中的新选项副本。

API

GAMS Engine API

• 更新GAMS Engine版本23.03.31。

GAMS Transfer Matlab

• 中断：Symbol.domain_labels现在镜像Symbol.records中域的列名或字段名。改变Symbol.domain_labels将改变Symbol.records，反之亦然。Symbol.domain_labels现在仅以struct和table格式存在。记录中的域字段是指不属于以下类型之一的字段：

  • 变量和方程：level、marginal、lower、upper、scale。
  • 参数：value。
  • 套件：text。

  此外，默认标签也发生了变化：如果Symbol.domain_names是域名的唯一列表，则这些名称用作域标签。否则，使用先前的标签策略“<name>_<dim>”。例如，具有域{i, j}的符号现在在记录中具有域标签i和j，并且具有域{i, j, i}的符号保持i_1、j_2、i_3（除非表列或结构字段由用户不同地命名）。

• 增加了修改Symbol.domain_labels到任何唯一的域标签列表的可能性。如果Symbol.domain被修改，则域标签被重置为如上所述的默认标签策略。
• 将Symbol.domain_forwarding更改为长度为Symbol.dimension的向量，以独立地启用/禁用每个维度的域转发。
• 删除了Symbol.getCardinality、Symbol.getUELLabels、Symbol.initUELs和Container.getUniverseSet。
• 修复了dense_matrix或sparse_matrix格式中符号的UEL可能不正确的顺序。
• 修复了单元格输入和维度>= 3的符号的Symbol.setRecords。

GAMS Transfer Python

• 中断：将generateRecords参数densities重命名为density。
• 中断：删除了getCardinality方法。
• 中断：将*符号的UniverseAlias列重命名为uni，以与其他符号格式更一致。
• 中断：新的数据框列命名约定。如果唯一，则默认为domain_names。如果不是唯一的，domain_names将被标记为维度索引。可使用新的domain_labels设定器功能进行定制。
• Container和ConstContainer已经变得可迭代。
• 向用户公开了Const*符号类，以实现更好的制表符完成行为。
• 新的符号方法toValue（用于标量符号）-返回符号记录为float（底层Pandas DataFrame未修改）。
• 新的符号方法toList（用于所有符号）-以python list的形式返回符号记录。
• 新的符号方法toDict（仅适用于参数，变量和方程符号类型）-以python dict的形式返回符号记录。
• 允许list中的bool被传递到domain_forwarding以选择性地转发集合元素。
• 遵循GAMS约定，单例集不能再用于定义符号域。
• 对对象字符串表示（__repr__）功能进行小调整。
• 为（常量）变量和（常量）表达式符号添加了is_scalar符号属性。
• 在len和Container中添加了对ConstContainer函数的支持-返回容器中的符号数。
• 在PathLike参数中添加了对load_from对象的支持。
• 更好地处理load_from参数中的str类型相对路径。
• 使用generateRecords时，从列中删除未使用的类别。
• 修复了getUELs中当域集中有未使用的类别并且数据与类别顺序不一致时的错误。toDense和toSparseCoo方法的受影响行为。
• 删除了以前不推荐使用的getUniverseSet方法，改用<container>.getUELs()。
• 如果所有符号值都是NaN，则whereMin、whereMax、whereMaxAbs函数的错误消息更好。

GAMS Transfer R

• 新库1.16.0.
  • 在Symbol 方法isValid()中添加了对单例检查和多维检查的检查。
  • 已更改默认域标签。如果用户指定的域标签唯一，则将保留该标签。
  • Container方法read中的性能改进。

GDX

• 添加了新的函数gdxDataReadRawFastEx，其行为类似于gdxDataReadRawFast，但它使用一个回调函数，该函数也具有DimFrst和UserMem参数。

GMO

• 添加了新的函数gmoGetObjL来获得客观的活动水平。这在重构模型时很有用。
• 函数gmoEvalFuncNLCluster和gmoEvalFuncNLCluster_MT已声明为弃用，并将在下一个主要版本中删除。

Java

• 此版本的GAMSModelInstance不再与GAMS 33或更早版本兼容。

Matlab

• 添加了选项implicitAssign到GAMSOptions和枚举类ImplicitAssign。

.Net

• 此版本的GAMSModelInstance不再与GAMS 33或更早版本兼容。

Python

• 支持Python 3.11。
• 此版本的GamsModelInstance不再与GAMS 33或更早版本兼容。
• 位于 <sysdir>/api/python/examples 中的Python示例已更新和修订。
  • 示例xp_example[1|2].py已重命名为core_example[1|2].py。

模型库

GAMS EMP库

• 更新了farmsp.gms : The Farmer's Problem - Stochastic.

GAMS模型库

• 更新了schulz.gms：终止例程，以确保求解器保持资源限制。
• gqapsdp 和 kqkpsdp: SDPs 现在使用Mosek求解。

GAMS测试库

• 更新了 carxr.gms : Test Connect agent RawExcelReader.
• 添加了 carcr.gms : Test Connect agent RawCSVReader.
• 添加了output01.gms：测试输出相关的命令行参数。
• 添加conopt03.gms：CONOPT测试套件-一个进程中的不同库。
• 添加interrupt.gms：检查嵌入式代码、MIP求解器和GAMS的Ctrl-C/中断处理。
• 添加load17.gms：测试$declareAndLoad和$gdxLoadAll。
• 添加了implassign01.gms：测试隐式分配。
• 将capdsqlr重命名为casqlr.gms：测试连接代理SQLReader并更新了修订版 SQLReader.
• 将capdsqlw重命名为casqlw.gms：测试连接代理SQLWriter并更新了修订版 SQLWriter.

43.2.0次要版本（2023年5月4日）

致谢

我们要感谢所有报告问题并为改进此版本提出建议的用户。我们特别感谢Michael Ferris和Mehmet Sert。

GAMS系统

GAMS

• 改进了美元控制选项$declareAndLoad，以考虑域信息和符号的子类型(例如，区分正变量和自由变量)。

求解器

CPLEX、GUROBI、XPRESS

• 修复了求解LPs或MIPs的基本模式不可用的问题。

Gurobi

• 修复了使用模型类型 (D/(R)MI)NLP.时拒绝包含二次方程的模型的问题。

工具

GAMS IDE

• 修复了GAMS不再运行的问题。

API

GAMS Transfer R

• 新版本1.18。
  • 为类型为isScalar和Variable的符号添加了Equation属性。
  • 更新符号方法reorderUELs()。如果参数uels未传递，则UEL将基于记录重新排序。
  • 符号方法isValid现在也检查具有多个记录条目的标量。
  • 中断：符号方法toDense()现在要求域UEL和域记录的顺序相同，并且域中未使用的UEL（如果有）位于UEL列表的末尾。
  • 中断：容器方法read现在保留了来自源的域类型，并避免了通过符号名称进行域链接。
  • 中断：删除符号方法getCardinality。
  • 修正了较长符号描述中的错误。
  • 修复了以不区分大小写的方式访问容器符号的错误。
  • 修正了容器方法描述的错误。

Jupyter Notebooks文件

• gams_reset的新可选参数-system _ directory = < path/to/gams >用于显式指定gams系统目录。

Python

• pip extras all和connect现在安装psycopg2-binary而不是psycopg2，以避免在安装GAMS Python API时产生额外的依赖性。

模型库

GAMS测试库

• 更新的 gamsjupyter01.gms : 测试 GAMS Jupyter Notebooks.