Example Program 9: MM_S9_Viz_RunInAdvance
Program Introduction
Description |
The Mech-Viz project is triggered when the robot performs picking. Then, the camera is started by the Branch by Msg Step of the project when the robot performs placing to plan the next path, shortening the cycle time. |
||
File path |
You can navigate to the installation directory of Mech-Vision and Mech-Viz and find the file by using the |
||
Project |
Mech-Vision and Mech-Viz projects
|
||
Prerequisites |
|
This example program is provided for reference only. Before using the program, please modify the program according to the actual scenario. |
Program Description
This part describes the MM_S9_Viz_RunInAdvance example program.
The only difference between the MM_S9_Viz_RunInAdvance example program and the MM_S5_Viz_SetBranch example program is that MM_S9_Viz_RunInAdvance can plan the next path (this code of this feature is bolded). As such, only the feature of planning the next path is described in the following part. For information about the parts of MM_S9_Viz_RunInAdvance that are consistent with those of MM_S5_Viz_SetBranch, see Example Program 5: MM_S5_Viz_SetBranch. |
DEF MM_S9_Viz_RunInAdvance ( )
;---------------------------------------------------
; FUNCTION: trigger Mech-Viz project then set
; branch and get planned path, trigger Mech-Viz
; project and set branch in advance during
; pick&place process
; Mech-Mind, 2023-12-25
;---------------------------------------------------
;set current tool no. to 1
BAS(#TOOL,1)
;set current base no. to 0
BAS(#BASE,0)
;move to robot home position
PTP HOME Vel=100 % DEFAULT
;initialize communication parameters (initialization is required only once)
MM_Init_Socket("XML_Kuka_MMIND",873,871,60)
;move to image-capturing position
LIN camera_capture Vel=1 m/s CPDAT1 Tool[1] Base[0]
;trigger Mech-Viz project
MM_Start_Viz(2,init_jps)
;set branch exit port
MM_Set_Branch(1,1)
LOOP
;get planned path, 1st argument (1) means getting pose in JPs
MM_Get_VizData(1,pos_num,vis_pos_num,status)
;check whether planned path has been got from Mech-Viz successfully
IF status<> 2100 THEN
;add error handling logic here according to different error codes
;e.g.: status=2038 means no point cloud in ROI
halt
ENDIF
;save waypoints of the planned path to local variables one by one
MM_Get_Jps(1,Xpick_point1,label[1],toolid[1])
MM_Get_Jps(2,Xpick_point2,label[2],toolid[2])
MM_Get_Jps(3,Xpick_point3,label[3],toolid[3])
;follow the planned path to pick
;move to approach waypoint of picking
PTP pick_point1 Vel=50 % PDAT1 Tool[1] Base[0]
;move to picking waypoint
PTP pick_point2 Vel=10 % PDAT2 Tool[1] Base[0]
;add object grasping logic here, such as "$OUT[1]=TRUE"
halt
;trigger Mech-Viz project but not to trigger camera capturing
MM_Start_Viz(2,init_jps)
;move to departure waypoint of picking
PTP pick_point3 Vel=50 % PDAT3 Tool[1] Base[0]
;move to intermediate waypoint of placing
PTP drop_waypoint CONT Vel=100 % PDAT2 Tool[1] Base[0]
;move to approach waypoint of placing
LIN drop_app Vel=1 m/s CPDAT3 Tool[1] Base[0]
;set branch exit port and trigger camera capturing when robot moves out of camera’s field of view
MM_Set_Branch(1,1)
;move to placing waypoint
LIN drop Vel=0.3 m/s CPDAT4 Tool[1] Base[0]
;add object releasing logic here, such as "$OUT[1]=FALSE"
halt
;move to departure waypoint of placing
LIN drop_app Vel=1 m/s CPDAT3 Tool[1] Base[0]
;move back to robot home position
PTP HOME Vel=100 % DEFAULT
ENDLOOP
END
The workflow corresponding to the above example program code is shown in the figure below.

The following part describes the feature of planning the next path.
Feature | Code and description | ||
---|---|---|---|
Plan the next path in advance by looping (picking→triggering the next round of path planning→placing) |
The above code indicates that the program loops through the code between LOOP and ENDLOOP.
The above code indicates that the robot obtains the planned path from Mech-Viz by running the MM_Get_VizData command.
The above code indicates that the robot stores the planned path in the specified variable by running the MM_Get_Jps command. This example program assumes that Xpick_point1, Xpick_point2, and Xpick_point3 are the approach waypoint of picking, the picking waypoint, and the departure waypoint of picking respectively.
The above code indicates that the robot moves to the approach waypoint of picking and then to the picking waypoint, and then the DO command (such as “$OUT[1]=TRUE”) is run to control the tool to perform picking.
The above code indicates that the robot runs the MM_Start_Viz command to start the Mech-Viz project again. Now that the robot has obtained the planned picking path of this round and has moved to the picking waypoint, you can start the Mech-Viz project in advance to plan the path of the next round instead of waiting for the placing to complete and then starting the Mech-Viz project.
The above code indicates that the robot moves to the departure waypoint of picking (pick_point3), the intermediate waypoint (drop_waypoint), and then the approach waypoint of placing (drop_app).
In the above example, the robot sets the exit port of the Branch by Msg Step with the MM_Set_Branch command. On this exit port, the Visual Recognition Step will be executed. Then, Mech-Viz will plan the next picking path in advance based on the vision result.
In the above example, the robot moves to the placing waypoint (drop), performs placing (for example, $OUT[1]=FALSE), and then moves to the departure waypoint of placing (drop_app) and then the home position. |