二维切割

场景说明

二维切割问题又称为排版问题(Nesting problems)或填充问题(Packing Problem)，是指将若干尺寸不相同的零件在给定的矩形原料上以最优的方式排布，要求所有待排零件都必须放在原料内，并且各个零件之间不发生重叠，并满足一定的工艺要求。切割问题普遍存在于工程领域，如服装排料、钣金下料、家具生产、玻璃切割。

排版软件在各离散制造行业已广泛使用，但自动排版算法存在实际落地的问题，主要包括：

1. 排版料率低：现有排版软件作业流程较冗长，原料利用率不够高，增加企业成本。

2. 切割效率低：现有排版软件排版方案切割路线长，加工效率低。

3. 排版约束不满足实际生产：排版约束多且复杂，现有排版软件使用的自动排版核心算法基于国外引擎，很难基于国内实际生产情况进行调整。

在使用OptVerse二维切割服务优化后，能够很好地支持企业解决以上问题。

服务架构

图1 二维切割服务架构

华为二维切割算法使用场景。用户按照华为云二维切割标准接口格式准备输入数据，调用华为公有云API，完成排版后，获取排版结果。

操作步骤

使用OptVerse服务之前，必须先申请华为云账号并进行实名认证。通过此账号，您可以使用所有华为云服务，并且只需为您所使用的服务付费。具体申请信息请见账号注册和实名认证。

调用OptVerse服务的具体步骤如下：

步骤1：购买服务：用户在OptVerse管理控制台页面“服务列表”栏选择二维切割服务购买套餐包。

步骤2：安装SDK：获取和安装SDK。

步骤3：开始使用：根据示例使用SDK发送请求，查看返回结果或状态码与错误码。

步骤1：购买服务

1. 登录

   a. 使用Chrome浏览器访问系统，打开登录页面。

   图2 登录页
   

   b. 输入华为云账号，用户名和密码 ，点击“登录”按钮， 登录成功后，进入OptVerse首页界面，如下图所示：

   图3 OptVerse首页
   
2. 套餐包管理

   a. 在使用OptVerse服务之前，用户需要进入套餐包管理页面点击购买套餐包，如下图所示：

   图4 套餐包管理
   

   b. 用户需要选择要使用的region（当前仅支持北京四）和服务，并选择总并发数进行分配，点击购买进行支付。

3. 授权

   a. 用户支付成功之后，进入授权管理页面，按照如下步骤创建自己的应用

   图5 总览
   
   图6 授权管理
   
   图7 创建应用
   
   图8 应用授权
   
   图9 授权服务1
   
   图10 授权服务2
   
4. 获取AppCode

   a. 调用服务需要获取应用的AppCode及用户所在节点的ProjectId，点击对应的应用进入应用详情，复制AppCode，如下图所示:

   图11 应用详情
   

   b. 鼠标移动至右上角用户名处，之后在弹框中选在我的凭证跳转至用户API凭证页，复制用户所需项目的ProjectId，如下图所示：

   图12 基本信息
   
   图13 项目列表
   

步骤2：安装SDK

OptVerse软件开发工具包（OptVerse SDK，Optical Character Recognition Service Software Development Kit）是对OptVerse服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用OptVerse SDK提供的接口函数即可实现使用OptVerse服务业务能力的目的。

我们针对不同语言的SDK提供了开发指南：

OptVerse接口与API对应关系请参见表2。

推荐您通过Maven方式获取和安装SDK，首先需要在您的操作系统中下载并安装Maven，安装完成后您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。

使用SDK前，需要安装“huaweicloud-sdk-core”和“huaweicloud-sdk-optverse”。SDK的版本信息请参见SDK中心。

<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-core</artifactId>
    <version>3.1.5</version>
</dependency>
<dependency>
   <groupId>com.huaweicloud.sdk</groupId>
   <artifactId>huaweicloud-sdk-optverse</artifactId>
   <version>3.1.5</version>
</dependency>

步骤3：开始使用

详细的SDK介绍，使用异步客户端，配置日志请参见SDK中心、Java SDK使用指导、Java SDK使用视频。

1. 导入依赖模块

   import com.huaweicloud.sdk.core.auth.ICredential;
   // 对用户身份进行认证
   import com.huaweicloud.sdk.core.auth.BasicCredentials;
   // Http配置
   importcom.huaweicloud.sdk.core.http.HttpConfig;
   // 请求异常类
   import com.huaweicloud.sdk.core.exception.ConnectionException;
   import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
   import com.huaweicloud.sdk.core.exception.ServiceResponseException;
   // 导入optverse sdk
   import com.huaweicloud.sdk.optverse.v1.region.OptVerseRegion;
   import com.huaweicloud.sdk.optverse.v1.*;
   import com.huaweicloud.sdk.optverse.v1.model.*;

2. 配置客户端连接参数
   • 默认配置

     // 使用默认配置
     HttpConfig config = HttpConfig.getDefaultHttpConfig();

   • 网络配置（可选）

     // 根据需要配置代理，默认的协议为 `http` 协议
     config.withProxyHost("proxy.huaweicloud.com")
         .withProxyPort(8080)
         .withProxyUsername("test")
         .withProxyPassword("test");

   • 超时配置（可选）

     // 默认连接超时时间为60秒，可根据需要调整
     config.withTimeout(60);

   • SSL配置（可选）

     // 根据需要配置是否跳过SSL证书验证
     config.withIgnoreSSLVerification(true);

3. 配置认证信息

   配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。

   • 使用永久AK和SK

     BasicCredentials basicCredentials = new BasicCredentials()
         .withAk(ak)
         .withSk(sk)

   认证参数说明：

   • ak、sk：访问秘钥信息，获取方法：登录“我的凭证> 访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。
   • projectId：华为云项目ID，获取方法：登录“我的凭证”页面，获取“IAM用户名”“、帐号名”以及待使用区域的“项目ID”。
   • AppCode：获取方法请参见图11。
4. 初始化客户端
   • 指定region方式（推荐）

     // 增加region依赖
     import com.huaweicloud.sdk.optverse.v1.region.OptVerseRegion;
     
     // 初始化客户端认证信息，使用当前客户端初始化方式可不填 projectId/domainId，以初始化 BasicCredentials 为例
     BasicCredentials basicCredentials = new BasicCredentials()
         .withAk(ak)
         .withSk(sk);
     
     // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务OptVerse的 OptVerseClient 为例
     OptVerseClient client = OptVerseClient.newBuilder()
         .withHttpConfig(config)
         .withCredential(basicCredentials)
         .withRegion(OptVerseRegion.valueOf("cn-north-4"))
         .build();

   • 指定云服务endpoint方式

     // 指定终端节点，以OptVerse服务北京四的 endpoint 为例
     String endpoint = "https://optverse.cn-north-4.myhuaweicloud.com";
     
     // 初始化客户端认证信息，需要填写相应 projectId/domainId，以初始化 BasicCredentials 为例
     BasicCredentials basicCredentials = new BasicCredentials()
         .withAk(ak)
         .withSk(sk)
         .withProjectId(projectId);
     
     // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务OptVerse的 OptVerseClient 为例
     OptVerseClient client = OptVerseClient.newBuilder()
         .withHttpConfig(config)
         .withCredential(basicCredentials)
         .withEndpoint(endpoint)
         .build();

     endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。

5. 发送请求并查看响应

   // 以调用天筹求解器查询任务列表接口ListTask为例
   ListTaskRequest request = new ListTaskRequest();
       request.withServiceGroup("2dcut");
       request.withServiceType("irregular-textile");
       request.withXApigAppCode("bbexxxxxxxxxx2089e3377xxxxxxxxxx92c49018afc04e64xxxxx29c980f56aa");
   try {
       ListTaskResponse response = client.listTask(request);
       System.out.println(response.toString());
   } catch (ConnectionException e) {
       e.printStackTrace();
   } catch (RequestTimeoutException e) {
       e.printStackTrace();
   } catch (ServiceResponseException e) {
       e.printStackTrace();
       System.out.println(e.getHttpStatusCode());
       System.out.println(e.getRequestId());
       System.out.println(e.getErrorCode());
       System.out.println(e.getErrorMsg());
   }

6. 异常处理

   表3 异常处理

   一级分类	一级分类说明	二级分类	二级分类说明
   ConnectionException	连接类异常	HostUnreachableException	网络不可达、被拒绝。
   		SslHandShakeException	SSL认证异常。
   		ConnectionTimeoutException	连接超时异常。
   RequestTimeoutException	响应超时异常	CallTimeoutException	单次请求，服务器处理超时未返回，包括读写超时等异常。
   		RetryOutageException	在重试策略消耗完成后，仍无有效的响应。
   ServiceResponseException	服务器响应异常	ServerResponseException	服务端内部错误，Http响应码：[500,]。
   		ClientRequestException	请求参数不合法，Http响应码：[400, 500)。

   // 异常处理
   try {
       ListTaskRequest request = new ListTaskRequest();
       ListTaskResponse response = client.listTask(request);
       System.out.println(response.toString());
   } catch (ServiceResponseException e) {
       e.printStackTrace();
       logger.error("HttpStatusCode: " + e.getHttpStatusCode());
       logger.error("RequestId: " + e.getRequestId());
       logger.error("ErrorCode: " + e.getErrorCode());
       logger.error("ErrorMsg: " + e.getErrorMsg());
   }