Keepout Zones and Saving/Loading Planning Scene

The Keepout Zones feature is designed to quickly define regions in the workspace where the robot(s) is prohibited from entering or interacting. This is crucial for avoiding obstacles and ensuring safe operation in dynamic environments. This guide informs on how to create, manipulate, and manage keepout zones within the planning scene.

Tutorial Level: Beginner

Keepout zones are implemented as 3D cubes in the planning scene. This tutorial will walk through:

1. Creating and visualizing keepout zones in the 3D planning scene.
2. Manipulating keepout zones, including moving, rotating, and deleting them.
3. Saving and loading keepout zone configurations to the planning scene.

Creating a Keepout Zone

You can create a keepout zone in the 3D planning scene by defining its size, orientation and position. This keepout zone will prevent the robot from moving into this region.

To create a keepout zone:

1. Open the Keepout Zones panel in the UI by clicking the box on the top left hand side of the Visualization view.
2. Use sliders to adjust size and orentaion of the cube. Enter positioning data for where the cube will show up on the 3d view.
3. Select Create.

Manipulating Keepout Zones

Once a keepout zone has been created, you can manipulate it further:

1. Select: Click on the keepout zone, the color will change to yellow and a directional interactive marker will appear.
2. Move: Click and drag the keepout zone to a new position using the arrows on the outside of the interactive marker.
3. Rotate: Use the circular interactive marker that appears on the edges of the keepout zone to adjust its rotation. Click and drag the circular handles to rotate the keepout zone around its axes.
4. Delete: To remove a keepout zone, select it and click the Delete or Backspace button.

Saving and Loading Keepout Zones

After defining your keepout zones, you can save them to a configuration file:

1. Click the Save Planning Scene button in the top left of the 3D Visualization View.
2. Provide a file name and click save.

To load previously saved planning scene, including keepout zones:

1. Click the Load Planning Scene button in the top left of the 3D Visualization View.
2. Select the configuration file to be uploaded.
3. Click the load button. (ensure that the current planning scene is saved as this load will overwrite it)