Warning

You are reading the documentation for an older Pickit release. Documentation for the latest release (3.1) can be found here.

Pick and place template

The Pickit pick and place template is a program node for executing vision-guided pick and place tasks with minimal programming effort. It provides an easy and intuitive interface for specifying relevant application knowledge, and abstracts away the complexity required to robustly execute the task.

This article presents the pick and place template in detail. Refer to the companion articles for an example pick and place program and the interface documentation (exposed variables and additional commands).

../../../_images/pick-and-place-overview.png

Note

The Pickit Pick and place template is only available for URCap 2.0 or later and Pickit 2.2 or later. Installation instructions can be found here.

The Pickit Pick and place template supercedes the low-level interface from URCap version 1 as the preferred way to set up a pick and place application, although both ways of working are supported.

Inserting the template

The pick and place template can be inserted in a robot program by selecting Program in the header bar, then URCapsPickit: pick and place on the left panel.

../../../_images/pick-and-place-insert-template.png

On insertion, you need to answer two basic questions about your application on the right panel and click Done for the template to initialize.

../../../_images/pick-and-place-basic-configuration.png

Power users can fine-tune pick and place behavior to a much finer degree than what the basic questions allow by entering the Advanced configuration. For instance, pick and place will by default continue until no more pickable objects are found, but it’s also possible to stop after a user-specified number of successful picks.

The pick and place template consists of a top-level node, three main sequences responsible for object detection, pick and place actions, and optional actions that can be selectively enabled according to the needs of the application.

../../../_images/pick-and-place-tree.png

Note

Lines marked in yellow by Polyscope indicate that they (or their nested commands) have uninitialized input parameters that must be set before running the program.

The template explained

The following statechart depicts the execution logic for the default pick and place configuration and a fixed camera mount. Optional actions are shown in dashed lines, and the places where Pickit is busy performing object detection are shown in green. Note that in the lower-right, object detection runs in parallel to the place sequence, which saves cycle time. If this parallel execution is not desired, it can be disabled in the advanced configuration.

../../../_images/pick-and-place-statechart.png

The motions involved in pick and place involve a number of waypoints, some of which are computed by Pickit (prefixed with Pickit and shown in green below), and three (in blue) which are user-defined:

  • Detect Where to perform object detection from. Refer to this article for guidelines on how to make a good choice.

  • Dropoff Where to place objects.

  • AbovePickArea A point roughly above the pick area from which the above two can be reached without collision. In simple scenarios, it can be the same as Detect.

../../../_images/pick-and-place-waypoints.png

Pick and place

The top-level node is meant for monitoring Pickit by showing a live camera stream overlaid with the ROI and detected objects (the same as the web interface 2D view). It also allows to access and modify the general pick and place Configuration (basic and advanced) which was set when inserting the template.

Inputs and configuration that are specific to the object detection, pick or place actions are specified in the corresponding action.

../../../_images/pick-and-place-top-level-node.png

Note that below the camera stream the connectivity to the Pickit system is displayed. The following are two examples of the Pickit system being connected and not:

../../../_images/pick-and-place-status-examples.png

Object detection

This sequence triggers a Pickit object detection.

../../../_images/pick-and-place-object-detection.png

Required inputs

  • Detect user-defined waypoint.

    Tip

    Some applications using a robot-mounted camera benefit from having extra logic that modifies the Detect point as the program executes. Examples:

    • De-palletizing, where the camera viewpoint lowers after emptying each layer.

    • Multiple viewpoints to cover bins wider than the camera field of view.

  • Find object node: Set the Pickit configuration (setup and product) that should be used for object detection.

../../../_images/pick-and-place-find-object.png

Check the Use the active Pickit configuration checkbox if you prefer to set the Pickit configuration programmatically with the Select command, instead of specifying it here. This is useful in complex applications, where the configuration is not known in advance, and depends on runtime variables.

Pick

This sequence performs the actual picking motion, which consists of a linear approach to the pick point, a grasping action, and a linear retreat away from it.

../../../_images/pick-and-place-pick.png

Tip

If your robot tool have the means to check pick success, consider incorporating this optional check to save cycle time.

Required inputs

  • AbovePickArea user-defined waypoint.

  • Tool action: Grasp folder: Populate with user-defined grasp logic.

    Note

    Its location in the Pick sequence depends on the gripper type set in the pick and place configuration. It can be located before (suction or similar) or after (fingered or similar) PickitPick.

Optional inputs

  • Pick node: Select a strategy for computing PickitPrePick and PickitPostPick, used in the approach and retreat motions, respectively.

    ../../../_images/pick-and-place-pick-strategy.png

Place

This sequence places the picked object at the specified dropoff location.

../../../_images/pick-and-place-place.png

Required inputs

  • Dropoff user-defined waypoint.

    Tip

    The robot sometimes needs to know about the way the object was picked, in order to place it appropriately. Refer to the smart placing examples to learn how to do this with minimal programming effort.

    It can also be the case that the drop-off point is not constant, as when parts need to be stacked or palletized. In such a case, Dropoff can be replaced with an instance of Universal Robot’s Palletizing template, for instance.

  • Tool action: Release: Populate with user-defined release logic.

Optional actions

The advanced configuration lists a number of optional actions whose execution can be enabled or disabled during pick and place. Their default contents are a suggestion, and can be modified.

Action before start

This sequence is executed once before starting pick and place. The default implementation performs a Release tool action, to prepare the gripper for picking.

This sequence is disbled by default.

../../../_images/pick-and-place-action-before-start.png

Action after end

This sequence is executed once after pick and place has finished. The default implementation identifies the termination reason and raises a popup if the requested number of picks was not reached. Pickit can discriminate the following situations:

  • Manual: The pickit_break() function was called. This is typically the case when an application-specific termination condition is met.

  • Empty ROI: The Region of Interest (ROI) has nothing inside.

  • No objects found: The ROI is not empty, but the requested object was not found.

  • No reachable objects: The requested object was found, but is unreachable by the robot.

  • No image captured: Pickit failed to capture a camera image, possibly due to the camera being disconnected.

This sequence is enabled by default as it provides useful information when setting up or debugging the application.

../../../_images/pick-and-place-action-after-end.png

Pick success check

If your robot tool has the means to check pick success from sensor input (like vacuum or force), the Place sequence can be skipped on pick failure, and save cycle time. The robot will instead proceed to pick a new object.

This action is disabled by default, as it requires additional user input. When enabled, it adds the following extra logic at the end of the Pick sequence.

../../../_images/pick-and-place-pick-success-check.png

Additional functionality

You can add custom logic to each sequence, adapting the pick and place template to your application’s needs while benefiting from the template modularity and abstraction. In particular, you can add Pickit commands that are outside the standard pick and place scope, such as: