Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
Gurobi 快速入门手册
版本 4.6.1,Copyright © 2011,Gurobi Optimization,Inc.
Gurobi 优化器由刃之砺信息科技(上海)有限公司在中国地区代理,
联系电话 021‐61508060,网址 www.edgestone‐it.com/gurobi.htm
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
页面:Gurobi Optimizer Quick Start Guide
Gurobi 优化器快速入门指南
版本 4.6,Copyright © 2011,Gurobi Optimization,Inc.
本文将简要地介绍 GurobiTM 优化器。首先要介绍的是软件安装指南和如何获取并安装
Gurobi 许可证信息,此外本文还会包括对 Gurobi 交互式命令解释器的简要说明。我们建议
您从这三节开始阅读。
取决于您将要使用的 编程语言,您还可以阅读 Gurobi 的 C 接口、C++ 接口、Java® 接口、
Microsoft®.NET 接口、或 Python® 接口等专门章节。我们所提供的 Python 接口对于那些想
要使用更高层次的建模结构来生成模型的用户来说将是十分重要的。
本文之后还会介绍文件概述,在该节中会对 Gurobi 发布中所包含的文件信息进行简要的概
述。
关于 Gurobi 接口的更多信息请参见 Gurobi 参考手册。Gurobi 发布中所提供的示例可参见
Gurobi 示例导览。
安装
如何获取并安装 Gurobi 许可证
o 教学验证疑难解答
o 令牌服务器的建立
交互式命令解释器
属性
C 接口
C++ 接口
Java 接口
.NET 接口(C#)
Python 接口
o 简单的 Python 示例
o Python 的字典示例
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
o 示例的生成与运行
文件概述
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
页面:Installation
安装
使用 Gurobi 优化器的第一步就是要在您的电脑上安装相关的文件。您应该已经从 Gurobi
网站(www.gurobi.com)获取了 Gurobi 的发布包。该发布包的名称取决于 Gurobi 优化器
的版本,以及要运行它的系统平台。例如,文件 Gurobi‐4.6.0‐win32.msi 可以在一台运行
Microsoft Windows® 操作系统的机器上安装 Gurobi 4.6.0 的 32‐位版本。另一方面,文件
gurobi4.6.0_linux64.tar.gz 可以在一台运行支持版本的 Linux® 操作系统的机器上安装 Gurobi
4.6.0 的 64‐位版本。
安装 Gurobi 优化器所需的步骤在 Windows、Linux、和 Mac OS 系统上不尽相同。下面将对
每个平台进行详细的说明。
安装—Windows
要在 Windows 机器上安装 Gurobi 优化器,只须要简单地双击合适的 Gurobi 安装程序(例
如,Gurobi 4.6.0 的 32‐位版本的安装程序为 Gurobi‐4.6.0‐win32.msi)。默认地,安装程序
会将 Gurobi 4.6.0 的文件存放到 c:\gurobi460\win32(64‐位的 Windows 安装程序会将文件
存放到 c:\gurobi460\win64)路径下。在安装程序中可以选择要安装的目标路径。我们用
来引用安装路径。
默认的 Gurobi 安装只允许当前的 Windows 用户使用它。如果想要让所有的用户都可以使
用 Gurobi,您可以使用 Windows 安装程序的命令行接口来实现:打开一个 cmd 提示窗
口,使用 cd 命令定位到包含 Gurobi 安装程序映像的路径,并输入以下命令:
msiexec /i Gurobi-4.6.0-win32.msi allusers=1
如果您想要在 Gurobi 优化器内使用压缩文件,我们建议您同时安装 gzip。可以从
www.gzip.org 下载该软件。
安装一旦完成之后,您应该可以在桌面上看到 Gurobi 的快捷方式。可以用它来运行
Gurobi 交互式命令解释器。现在您还不应该尝试去运行 Gurobi。这样做会产生冗长的错
误信息指示您还未安装许可证。
您现在可以继续阅读如何获取并安装 Gurobi 许可证节。
如果您想要了解 Gorubi 发布中所包含的文件信息,请参阅文件概述节。
安装——Linux
在 Linux 系统中安装 Gurobi 优化器的第一步是选择一个目标路径。对于共享安装我们建议
使用 /opt,但其他的路径也能够工作。
一旦选择了目标路径,下一步就是将 Gurobi 发布复制到该目标路径中并提取其内容。可以
使用以下命令来完成内容提取:
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
tar xvfz gurobi4.6.0_linux64.tar.gz
该命令会创建一个子路径 gurobi460/linux64,其中包含了完整的 Gurobi 发布。默认情况
下, 为 /opt/gurobi460/linux64。当然,须要对文件和路径名称进行调整以反映
真正要安装的发布(例如,提取 32‐位的 Linux 发布(gurobi4.6.0_linux32.tar.gz)则会创建
/opt/gurobi460/linux32)。
Gurobi 优化器会使用一些可执行文件。为了在需要时能够找到这些文件,您须要修改一些
环境变量:
GUROBI_HOME 应该指向 。
应该扩展 PATH 以包含 /bin。
应该扩展 LD_LIBRARY_PATH 以包含 /lib。
Bash shell 的用户须要在 .bashrc 文件中添加以下行…
export GUROBI_HOME="/opt/gurobi460/linux64"
export PATH="${PATH}:${GUROBI_HOME}/bin"
export LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:${GUROBI_HOME}/lib"
csh shell 的用户则须要在 .cshrc 文件中添加以下行…
setenv GUROBI_HOME /opt/gurobi460/linux64
setenv PATH ${PATH}:${GUROBI_HOME}/bin
setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${GUROBI_HOME}/lib
如果还没有设置 LD_LIBRARY_PATH,请改为使用以下行进行设置:
export LD_LIBRARY_PATH="${GUROBI_HOME}/lib"
或
setenv LD_LIBRARY_PATH ${GUROBI_HOME}/lib
同样地,须要对这些路径进行调整以反映真正要安装的发布。
您现在可以继续阅读如何获取并安装 Gurobi 许可证节。
如果您想要了解 Gorubi 发布中所包含的文件信息,请参阅文件概述节。
安装——Mac OS
要在 Mac 上安装 Gurobi 优化器,只须要简单地双击合适的 Gurobi 安装程序(例如,
Gurobi 4.6.0 的安装程序为 gurobi4.6.0.pkg),并遵循其提示。默认地,安装程序会将
Gurobi 4.6.0 的文件存放到 /Library/gurobi460/mac64。
您现在可以继续阅读如何获取并安装 Gurobi 许可证节。
如果您想要了解 Gorubi 发布中所包含的文件信息,请参阅文件概述节。
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
页面:How to Obtain and Install a Gurobi License
如何获取并安装 Gurobi 许可证
通过以下两个步骤可以获取一个新的 Gurobi 许可证密钥:首先在我们的网站上创建一个新
的许可证,然后生成一个许可证密钥将我们网站上的那个许可证与您的机器进行关联。下
面让我们依次对这两个步骤进行讨论:
新许可证的创建
创建许可证的过程取决于要创建的许可证类型:
试用或教学许可证:可以直接在我们的网站上创建试用或教学许可证:访问
www.gurobi.com Gurobi 帐户中“Licenses”区域的“Free Trial”或“Free
Academic”页面、接受许可证协议、然后单击“Submit Request”。您立即就可以
在“My Licenses”页面中看到您所创建的许可证。您可以根据需要创建任意多个试
用或教学许可证。
当日付款许可证:当日付款许可证也可以直接在我们的网站上创建:访问
www.gurobi.com Gurobi 帐户中“Licenses”区域的“Pay‐By‐The‐Day”页面,然后将
您想要购买的许可证添加到购物车中。准备好之后,单击“Checkout”,就会跳转
到 Google 支付页面,在该页面中可以通过信用卡来支付您所购买的许可证。几分
钟之内(一旦支付过程完成以后)您就可以在“My Licenses”页面中看到新创建的
许可证。
其他的收费许可证:关于其他的收费许可证,请联系我们(license@gurobi.com)
以便安排支付事宜。一旦收到付款我们就会立即与您取得联系,此时您就可以在
“My Licenses”页面中看到新创建的许可证。
在“My Licenses”页面看到新的许可证之后,单击许可证 ID 会生成如下所示的页面:
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
下一个步骤就是获取一个许可证密钥,将新创建的许可证与您的机器关联起来。
许可证密钥的获取
要获取 Gurobi 的许可证密钥,请先将一台须要运行 Gurobi 优化器的机器连接到网络、然
后在这台机器上运行 grbgetkey 命令。如果您所使用的是免费的教学许可证,那么您的机
器就必须连接到可以辨识的教学域中。如果您的电脑未连接到网络,并且您所请求的是收
费许可证,请联系我们(license@gurobi.com)来得到关于如何获取许可证密钥的进一步说
明。请注意,一旦获取了许可证密钥就不再需要网络连接了。
特定许可证所对应的须要运行的具体命令位于许可证页面的底部(例如,grbgetkey
bba60259‐…)。我们建议您使用复制‐粘帖的方法从我们的网站获取完整的 grbgetkey 命
令。在 Windows 系统中,可以直接将该命令粘帖在 Windows 的搜索框(在 Windows XP 中
称为运行框)中。在 Windows 7 中如下所示:
Gurobi v4.6.1 快速入门手册。刃之砺信息科技(上海)有限公司代理和翻译。http://www.edgestone‐it.com/gurobi.htm
在 Linux 机器上,将该命令粘帖在 shell 窗口中。在 Mac 系统中,则将该命令粘帖在
Terminal 窗口中。
grbgetkey 程序会将机器的识别信息传递回我们的网站,而网站则会回复许可证密钥。这
样的信息交换一旦发生,grbgetkey 就会询问用于存储许可证密钥文件的路径名称。虽然
可以将该文件存储在任何地方,但我们还是建议您接受默认的位置(简单地敲击回车键即
可)。
许可证密钥文件的存储位置
运行 Gurobi 优化器时,它会在三个不同的默认位置寻找 gurobi.lic 许可证密钥文件。始终
会查找的是主目录。此外,在 Windows 系统中,Gurobi 优化器 4.6.0 还会查找 c:\gurobi460
或 c:\gurobi46 路径。在 Linux 系统中查找的是 /opt/gurobi460 以及 /opt/gurobi46。而在
Mac 系统中则会查找 /Library/gurobi460 和 /Library/gurobi46。请注意这些默认路径都是绝
对路径,所以举例来说,即使软件安装在 d:\gurobi460,Gurobi 仍然会在 c:\gurobi460 中寻
找许可证密钥文件。
如果想要将您的许可证存储在一个非默认的位置,您就必须设置环境变量
GRB_LICENSE_FILE 使其指向许可证密钥文件。重要注意事项:环境变量应该指向许可证密
钥文件本身,而不是指向包含该文件的路径。
在 Windows 系统中,可以在控制面板中创建并修改环境变量。对于 Windows Vista® 或
Windows 7,在控制面板的搜索框中输入“Environment Variables”,系统就会引导您进入
正确的页面。对于 Windows XP®,在控制面板的“系统”窗口中选择“高级”页面,单击
“环境变量”按钮来访问环境变量窗口。如果想要将许可证密钥文件放置在非默认的位
置,就须要添加一个名为 GRB_LICENSE_FILE 的新系统变量,并将其设置为许可证文件所在
的位置。
在 Linux 系统中,如果选择将许可证密钥文件放置在非默认的位置,就须要在 .bashrc 文件
中添加一行,如下所示:
export GRB_LICENSE_FILE=/usr/home/jones/gurobi.lic
对于 Linux csh shell 的用户,须要在 .cshrc 文件中添加以下行: