创建任务
功能介绍
二维切割服务基于数学规划和元启发式算法的优化引擎,适用于家具行业板材、石材切割,机械制造中的钣金切割,建筑领域的玻璃切割,服装领域的布料排版切割,在满足客户多样化的约束场景和切割策略选择的需求下,为客户提供高利用率、高效率的切割方案。
URI
POST /v2/{project_id}/optverse/regular-plate/tasks
请求参数
二维切割前的原材料请求参数如表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所示。
参数 |
是否必须 |
参数类型 |
说明 |
---|---|---|---|
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所示。
参数 |
是否必须 |
参数类型 |
说明 |
---|---|---|---|
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所示。
- 失败响应示例
{ "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" }