gurobi

DolphinDB server 2.00.12 及更高版本，支持 Linux x86-64。

1. 在 DolphinDB 客户端中使用 listRemotePlugins 命令查看插件仓库中的插件信息。

   注意：仅展示当前操作系统和 server 版本支持的插件。若无预期插件，可自行编译（请自行选择对应分支下的插件）或在 DolphinDB 用户社区进行反馈。

   login("admin", "123456")
   listRemotePlugins()

2. 使用 installPlugin 命令完成插件安装。

   installPlugin("gurobi")

3. 使用 loadPlugin 命令加载插件。

   loadPlugin("gurobi")

语法

model([params])

详情

建立一个 Gurobi 模型对象，可以通过 params 设置参数。

返回创建的 Gurobi 模型对象。

参数

params 一个字典，其键值的类型均为 STRING，可选参数，为空时表示建立一个默认的模型对象。参考 Gurobi 文档的 Parameters。

示例

gurobi::model(dict(["NonConvex"], ["2"]))

语法

addVars(model, lb, ub, obj, type, varName)

详情

为模型添加新的决策变量。

返回此次添加的变量名的数组。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

lb DOUBLE 类型数组，数组中的每个元素表示对应变量的下界（lower bound）。

ub DOUBLE 类型数组，数组中的每个元素表示对应变量的上界（upper bound）。

obj DOUBLE 类型数组，数组中的每个元素表示对应变量在目标函数中的系数。参数 obj 可以为 NULL，此时所有变量的系数均为默认值 0.0。

type CHAR 类型数组，每个字符表示对应变量的类型。参数 type 可以为 NULL，此时所有变量的类型均为默认值 'C'：

• 'C': 表示连续变量（Continuous）
• 'B': 表示二元变量（Binary）
• 'I': 表示整数变量（Integer）
• 'S': 表示半连续变量（SEMICONT）
• 'N': 表示半整数变量（SEMIINT）

varName STRING 类型数组，数组中的每个字符串用于命名对应的变量。

语法

linExpr(model, coefficient, varName)

详情

创建线性表达式对象，并返回该对象。

参数

**model **通过 model 接口创建的 Gurobi 模型对象。

**coefficient **DOUBLE 类型数组，数组中的每个元素表示变量的系数。

**varName **STRING 类型数组，对应 model 模型中的变量。

语法

quadExpr(model, quadMatrix, varNames, [linExpr])

详情

创建二次表达式对象，并返回该对象。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

quadMatrix DOUBLE 类型矩阵：

• 通过累加系数(quadMatrix[r][c]) * 该行表示的变量(varName[r]) * 该列表示的变量(varName[c])，得到二次表达式。
• 注意虽然 DolphinDB 的矩阵是列存，理论上应该 transpose 转置，但因为 quadMatrix[r][c] 和 quadMatrix[c][r] 的作用是完全等价的（因为 c * obj_r * obj_c = c * obj_c * obj_r），所以实际使用中无需转置，当成行优先的矩阵直接使用即可。

varName STRING 类型数组，对应 model 中的变量。

linExpr 通过 linExpr 接口创建的线性表达式对象，用来初始化二次表达式对象，可选参数。

语法

addConstr(model, lhsExpr, sense, rhsVal)

详情

为模型添加单个线性或二次约束。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

lhsExpr 通过 linExpr 或 quadExpr 接口创建的表达式对象。

sense 类型为 CHAR，表示约束类型：

• '<': GRB_LESS_EQUAL
• '>': GRB_GREATER_EQUAL
• '=': GRB_EQUAL

rhsVal DOUBLE 类型标量，作为约束条件的限制值。

语法

setObjective(model, expr, sense)

详情

定义模型的优化目标。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

lhsExpr 通过 linExpr 或 quadExpr 接口创建的表达式对象。

sense 类型为 INT，指定优化方向：

• -1: GRB_MAXIMIZE
• 1: GRB_MINIMIZE

语法

optimize(model)

详情

根据设置的目标函数和约束来寻找最优解，获取模型求解后的状态。

返回模型求解后的状态，类型为 INT，含义参考 Gurobi 文档的 Optimization Status Codes。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

语法

getResult(model)

详情

获取优化后参数的取值。

返回优化后的变量求解结果字典，其中包含了模型中所有变量的名称和对应的值。

参数

model 通过 model 接口创建的 Gurobi 模型对象。

语法

getObjective(model)

详情

获取优化后的目标值。

获取优化模型求解后的目标函数值，类型为 DOUBLE。

参数

model 通过 model 接口创建的 Gurobi 模型对象。