更新时间:2024-06-25 GMT+08:00
分享

创建任务

功能介绍

二维切割服务基于数学规划和元启发式算法的优化引擎,适用于家具行业板材、石材切割,机械制造中的钣金切割,建筑领域的玻璃切割,服装领域的布料排版切割,在满足客户多样化的约束场景和切割策略选择的需求下,为客户提供高利用率、高效率的切割方案。

URI

POST /v2/{project_id}/optverse/regular-plate/tasks

请求参数

二维切割前的原材料请求参数如表1所示。

表1 原料请求参数说明

参数

是否必须

参数类型

说明

plate_id

Int

原材料ID

plate_length

Float

原材料长

plate_width

Float

原材料宽

plate_thick

Float

原材料厚度

plate_material

String

原材料制作材料

plate_grain

Bool

原材料是否有纹路

plate_num

Int

原材料数量

is_offcut

Bool

是否为余料

plate_cost

Float

原材料成本

二维切割后的成品请求参数如表2所示。

表2 成品请求参数说明

参数

是否必须

参数类型

说明

item_id

int

成品ID

item_length

Float

成品长

item_width

Float

成品宽

item_thick

Float

成品厚度

item_num

Int

成品数量

item_turn

Bool

成品是否可以旋转(无纹路:true,有纹路:false)

item_material

String

成品材料

item_name

String

成品名称

is_substitute

Bool

是否为替补板

label_info

是(键值对内的信息可随意增加与删减)

map<String,String>

打印标签信息的键值对组合

二维切割条件参数的请求参数如表3所示。

表3 切割条件参数的请求参数说明

参数

是否必须

参数类型

说明

kerf_horizontal

Float

横向锯刀宽度

kerf_vertical

Float

纵向锯刀宽度

plate_trim_horizontal

Float

原材料横向修边量

plate_trim_vertical

Float

原材料纵向修边量

item_forward_trim

Float

再分锯切前向修边量

item_backward_trim

Float

再分锯切后部修边量

first_cut_direction

Int

进料方向(横向0,纵向1,任意方向2)

max_stack_height

Float

最大叠板高度

calculate_time

Int

算法的最长计算时间

offcut_length

Float

余料长度下限

offcut_width

Float

余料宽度下限

offcut_area

Float

余料面积下限

time_cost

Float

每小时的锯切时间成本

max_cut_stage_num

Int

开始切割后,同一个方向上的切割,统计为一次,需在设置的转板次数内,将大板切割完毕

min_stack_utilization

Float

最小的叠板利用率

item_sort_location

Bool

长条板件中部件的放置顺序,true最大部件放在左侧,false最大部件放在右侧

item_num_limit

Int

锯切图上的小板种类数量限制

示例

  • 请求示例
    POST https://{endpoint}/v2/{project_id}/optverse/regular-plate/tasks
    Request Header:
    Content-Type: application/json;charset=utf-8
    Auth-Token:
    Body:
    {
        "items": [
            {
                "item_id": 0,
                "item_material": "18MM_PLATE",
                "item_length": 60.0,
                "item_width": 553.0,
                "item_turn": true,
                "item_num": 1,
                "item_name": "底板",
                "item_thick": 18,
                "is_substitute": false,
                "label_info": {
                    "order_code": "订单号",
                    "plan_code": "批次号",
                    "item_code": "小板标识"
                }
            },
            {
                "item_id": 0,
                "item_material": "18MM_PLATE",
                "item_length": 60.0,
                "item_width": 553.0,
                "item_turn": true,
                "item_num": 1,
                "item_name": "底板",
                "item_thick": 18,
                "is_substitute": true,
                "label_info": {
                    "order_code": "订单号",
                    "plan_code": "批次号",
                    "item_code": "小板标识"
                }
            }
        ],
        "parameters": [
            {
                "calculate_time": 30,
                "first_cut_direction": 2,
                "item_backward_trim": 0.0,
                "item_forward_trim": 0.0,
                "kerf_horizontal": 4.4,
                "kerf_vertical": 4.4, 
                "max_stack_height": 80,
                "plate_trim_horizontal": 10.0,
                "plate_trim_vertical": 10.0,
                "time_cost": 200,
                "max_cut_stage_num": 3,
                "min_stack_utilization": 0.8,
                "item_sort_location": false,
                "item_num_limit": 0
            }
        ],
        "plates": [
            {
                "plate_grain": true,
                "plate_id": 0,
                "plate_length": 2440.0,
                "plate_material": "18MM_PLATE",
                "plate_num": 9999,
                "plate_thick": 18.0,
                "plate_width": 1220.0,
                "plate_cost": 100
            }
        ]
    }
  • 成功响应示例
    {
        "task_id": "40axxxx-701a-47cf-8b56-648xxxxxxd25"
    }

    参数说明如表4所示。

    表4 参数说明

    参数

    参数类型

    说明

    task_id

    String

    任务ID

  • 失败响应示例
    {
        "error_code": "optverse.00000006",
        "error_msg": "Input data validate error: the item material is 18MM_PLATE, item_id is 0: Length and width are larger than plate.\n"
    }

相关文档