快速入门(开通和使用)

优化求解器的快速入门方式。包含开通服务、下载安装软件、配置鉴权文件和一个快速运行的例子。

1. 开通服务

访问控制台开通服务。然后会在已购服务列表中获取到LicenseKey。

说明
  • 当前数学规划求解器开放使用,免费,开通和购买时账单金额为0。

开通

新用户首次购买需在控制台单击开通来开通服务,然后再单击0元购买,选择您需要的时长和进程数。购买以后还可以续费变配,会如下图所示:

开通和购买

查看已购服务和LicenseKey

单击左侧导航栏的已购服务列表,会看到已经购买的服务,卡片中有显示LicenseKey。如下图示意:

image

2. 下载SDK和安装

请根据求解器SDK下载和安装的描述,下载您需要的版本并安装。

3. 使用阿里云鉴权LicenseKey

配置鉴权账号信息

MindOpt在求解问题时,需要License。您购买服务后,可在已购服务列表中看到LicenseKey,可用于配置鉴权文件 fl_client.ini ,此文件放置地址请查阅安装步骤中的4. 配置鉴权文件,建议设置环境变量MINDOPT_LICENSE_PATH 来定义鉴权文件放置的位置。如果没有 fl_client.ini 文件,请创建它,并复制粘贴下文的内容示例并修改。

文件fl_client.ini 的内容示例如下:(请点击左下角在“文档中心打开”此页面复制以下内容,小窗文档复制功能目前有异常)

[security]
# key for client authentication 
aliyun_license_key = xxx #请修改成您购买服务的LicenseKey信息,见控制台的已购服务列表(开通服务中描述)

aliyun_ak_id= xxx #请修改成您阿里云账号的AccessKey信息

aliyun_ak_secret= xxx #请修改成您阿里云账号的AccessKey Secret信息

#以下内容复制后,无特殊情况不需要更改
[server]
# license server host
name = opt.cn-beijing.aliyuncs.com # 请修改为您购买区域的endpoint,与购买区域对应。

# license server port 80 if absent
port = 443

# license server is https protocol
https = true

# client side request timeout in second
request_timeout  =   2

其中:

fl_client.ini 文件中需要修改的账号配置如下:

  1. security段中,aliyun_license_key可在控制台>已购服务列表查看到LicenseKey。没有购买请根据前文的指引进行开通和购买。

  2. security段中,aliyun_ak_idaliyun_ak_secret 需要修改成您自己阿里云主账号或者RAM子账号,方式如下说明:

    说明

    如何创建访问密钥AccessKey:

    控制台页面的右上角,鼠标悬浮在头像上,即可看到弹出栏里面有一条“AccessKey管理”,点击进行操作即可。

    也可看以下的专业版操作讲解:

    • 主账号:主账号创建访问密钥请在AccessKey管理创建。

    • RAM子账号:如果使用了RAM子账号可以参考为RAM用户创建访问密钥。RAM子账号创建访问密钥后,需要主账号授予当前子账号优化求解器的管理权限。

4. 一个快速求解的例子

我们在SDK包中有放置一个examples文件夹,里面会有示例的各种语言的代码和示例数据。假设用户已按照安装文档,MindOpt安装时正确设置了安装目录环境变量MINDOPT_HOME

  • 以命令行指令为例:

  1. Linux或macOS系统

mindopt $MINDOPT_HOME/examples/data/afiro.mps

2. Windows系统

mindopt %MINDOPT_HOME%\examples\data\afiro.mps MaxTime=10800 SPX/MaxIterations=1000000000

  • 以Python的代码运行为例,您可以打开该.py文件查看里面的示例源代码:

  1. Linux或macOS系统

python $MINDOPT_HOME/examples/python/read_mps.py --filename $MINDOPT_HOME/examples/data/afiro.mps

2. Windows系统

python "%MINDOPT_HOME%\examples\python\read_mps.py" --filename "%MINDOPT_HOME%\examples\data\afiro.mps"
重要

当前支持Python 3.6+版本,3.8+版本在运行给出的示例代码时,可能会提示找不到mindoptpy的问题,处理方案见用户文档

更多的使用说明,请阅读求解器用户手册

上述命令行和Python的示例都是求解一个afiro.mps优化问题文件,运行结果如下图所示意:

20230807下午20957.jpg