/
RapidPlan Create 2.5 Layout

RapidPlan Create 2.5 Layout

 

The RapidPlan Create application is divided into the sections described below. RapidPlan Create has two modes: Model Mode and Roadmap Mode. The Tool Bar will be different when either of the two modes is active.

RapidPlan Create (with Roadmap mode active)

Menu Bar

The menu bar contains the File, Edit, Camera and About menus, whose options are described below.

File Menu

New Project

New Project (Ctrl+N) – Create a new project. When RapidPlan Create opens up the first time, the application will open in Model Mode in a new project.

Save Project

Save Project (Ctrl+S) - Saves the current project. The first time you save a project, you will need to create and name new folder in which to save the project. After that, the save command will save the project to that folder.

Save Project As…

Save Project As… (Ctrl+Shift+S) - Copies the current project to a new location and a new name you choose.

Open Project

Open Project - Displays the project directory, from which you choose an existing project. The current project will be closed and the chosen project loaded into RapidPlan Create.

When opening a project, you may see the “auto save found” dialog if the application was terminated without manual saving of the latest file. If you want to recover the latest unsaved file, press yes.

 

Open Recent Project

Open Recent Project - Displays a submenu of recent projects from which to choose.

Import Frames

Import frame data from another project or from a spreadsheet, which has been saved as a .txt or .csv file using either comma or space delimiters. The selection is available in Model Mode only and is disabled in Roadmap Mode. If the imported frames' names already exist in the project, a pop up dialog is enabled to allow users to replace or skip the frame(s) with duplicate names.

Import Frames Dialog and duplicate names popup dialog

 

File - The name of a .txt or .csv file.

 

Each line of the file must contain only the information of one frame. The file cannot have empty lines. The names of the frames must follow RapidPlan Create naming conventions. The engineering units of the frames are based on current project settings. The example above uses engineering units next to the numbers. There is no obligation of having these units to be the same as project-set engineering units. However, the units used in this example(next to the numbers) are optional and if they’re omitted only then project-set units will be used.

Browse - Browse your file manager to open a .txt or .csv file, which can be imported. The default file location is your home folder.

Parent Frame - The parent frame for which the frame is to be imported. The selection is from the drop-down list of existing frames in the project. The default selection is the Origin.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the imported file. (In this example, the delimiter is a space.

Include names on each line - Check the box if you want to include the names on each line of the imported file in your RapidPlan Create project. In this example, the names of the imported frames are rear_bottom_align, rear_top_align, front_bottom_align, etc. and they do follow RapidPlan Create naming conventions.

Name prefix - If the imported file does not include frame names on each line, you can add a name prefix to each frame. The imported frame names will start with the prefix, followed by the 0-based line number of each imported frame. For example, if Name Prefix = “newframe”, then imported frames will be newframe0, newframe1, newframe2, etc.

Import Targets

Import targets from a file of .txt or .csv format. This dialog is similar to the Import Frames dialog but is available in Roadmap Mode only and is disabled in Model Mode. Imported targets can be duplicates.

Import Targets Dialog

File - The name of a .txt or .csv file. Each line of the file must contain exactly one target’s information. The file cannot have empty lines. The names of the targets must follow RapidPlan Create naming conventions.

Browse - Browse your file manager to open a .txt or a .csv file, which can be imported. The default file location is your home folder.

Import As - Select the format of the imported targets as either Pose Coordinates or as a robot’s joint configurations.

Import as Pose Coordinates - Import targets with x, y, z, r, p, y pose coordinates. The engineering units for pose coordinates can be specified for each value, e.g., mm, cm, m, ft, in, rad, deg, or degs, or °. If engineering units are specified, they must be defined for all values. If the engineering units are not specified, the project-set engineering units will be applied to the coordinates values.

Parent Frame - The parent frame for which the targets is to be imported. The selection is from the drop-down list of the existing frames. The default selection is the Origin.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the imported file.

Include names on each line - Check the box if you want to include the target names on each line of the imported file in your RapidPlan Create project. The names of the imported targets need to follow RapidPlan Create naming conventions.

Name prefix - If imported targets do not include names on each line, a name prefix can be added to each target. The imported target names will start with the prefix, followed by the 0-based line number of each imported frame. For example, if Name Prefix = “newtarget”, then imported targets will be newtarget0, newtarget1, newtarget2, etc.

 

Import as Joint Configurations - Import targets with the joint configurations of a robot preset. The engineering units can be specified for each value, e.g., rad or °. If engineering units are specified, they must be defined for all values. If the engineering units are not specified, the project settings will be applied to the coordinates values. The imported targets may also have robot driver indices included, e.g., J0, J1…etc. The driver indices must be defined in the first line and the number of indices must match the number of joint configuration values for each target.

Robot - Robot name for the targets to be imported. The selection is from the drop-down list of the existing robots.

Robot Preset - Preset name of the robot selected.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the imported file.

Include names on each line - Check the box if you want to include the target names on each line of the imported file in your RapidPlan Create project. The names of the imported targets need to follow RapidPlan Create naming conventions.

Name prefix - If imported targets do not include names on each line, a name prefix can be added to each target. The imported target names will start with the prefix, followed by the 0-based line number of each imported frame. For example, if Name Prefix = “newtarget”, then imported targets will be newtarget0, newtarget1, newtarget2, etc.

Export Frames

Export frame data to a .txt or .csv file using either comma or space delimiters. Export frame data can be selected in either Model Mode or Roadmap Mode.

Export Frames Dialog

File - A .txt or .csv file.

Browse - The default location for the exported file is the home folder of the current user.

Parent Frame - A parent frame for the targets to be exported. The selection is from the drop-down list of the existing frames. The default selection is the Origin.

Line Delimiter - select Space, Comma or Tab as the delimiter for the exported file.

Include names on each line - Check to include frame names on each line.

Include units - Check to include engineering units for each frame’s coordinates values.

Export Targets

Export target data to a .txt or .csv file using either comma or space delimiters. Export target data can be selected in either Model Mode or Roadmap Mode.

Export Targets Dialog

File - a .txt or .csv file.

Browse - The export file location, which defaults to the home folder of the current user.

Export As - To select the format of the exported targets as either Pose Coordinates or as a robot’s joint configurations.

Export as Pose Coordinates - Export targets with x, y, z, r, p, y pose coordinates.

Parent Frame - a parent frame for the targets to be exported. The selection is from the drop-down list of the existing frames. The default selection is the Origin.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the exported file.

Include names on each line - Check to include target names on each line.

Include units - Check to include engineering units for each target’s coordinates values.

 

Export as Joint Configurations - Export targets as joint configurations of a robot preset. Only targets assigned to the selected robot preset will be exported.

Robot - Robot name for the targets to be exported. The selection is from the drop-down list of the existing robots.

Robot Preset - Preset name of the robot selected.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the exported file.

Include names on each line - Check to include target names on each line.

Include units - Check to include engineering units for each targets joint configurations values.

Include driver indices - Check to include driver indices, e.g., J0, J1, etc., for each target's joint configurations values.

Exclude invalid targets - Check to exclude any targets that are invalid, i.e. targets that are resulting in collision or targets with invalid IK solutions or targets that have not been validated.

Export Target Sequence

Export target sequence information, including joint configurations at each via location, connection types, etc. to a .txt file using comma, space, or tab delimiters.

Export target sequence data can only be selected in Roadmap Mode.

Export Target Sequence Dialog

File - a .txt file.

Browse - The export file location, which defaults to the home folder of the current user.

Target Sequence - The name of the target sequence to be exported (selected from the Property Tree).

Robot - The robot containing the target sequence.

Robot Preset - The name of the robot preset containing the target sequence.

Export As - Joint Configurations is the only option.

Line Delimiter - Select Space, Comma or Tab as the delimiter for the exported file.

Include names on each line - Check to include target names on each line.

Include units - Check to include engineering units for each target's joint configurations values.

Include driver indices - Check to include driver indices, e.g., J0, J1, etc., for each target's joint configurations values.

Project Settings

Units - Set the length, angle, and area measurement units for your model; set how many decimal places to display for the desired level of precision. The default values are mm, °, mm2.

Voxel Size - Size of the voxel for collision detection calculation. The minimum value is 2mm. The recommended value, which is also the default value, is 20 mm. This is only used for robot-robot collision checking.

Robot Dilation - Robot dilation is used to increase the voxelization volume of every robot to avoid collisions with other robots, or DSM/RapidSense voxels. The minimum value is 2mm. The recommended value, which is also the default value, is 15mm. You can only change the dilation value in Model Mode.

Robot-World Clearance - Defines minimum distance that should be respected by Rapid Plan during motion planning and roadmap creation for a robot. Currently, this is used for a complete robot-to-world collision checking and in planned connections (Auto-Connect). The default Robot-World clearance value is 0.1 mm. While the default clearance value for Auto-Connect, as accessible under the Roadmap Mode - Connect - Auto-Connect dialog, is 10mm, the clearance value accepted here cannot be lower than the value specified under Robot-World clearance.

Scene - Display or hide edges on robots and other objects in the workcell, and choose the type of robot drag mode to be used: Natural or Screen Y.

Robot Drag Mode:

Screen Y: The default setting. It means the robot moves in relation to the screen’s Y axis. Regardless of the orientation of the 3D View, when you drag the mouse up, the joint moves in a positive direction; drag the mouse down to jog the joint in the negative direction.

Natural: In Natural mode you move your mouse not up and down, but in the direction you want the joint to move. So, for example, click on a robot joint then move your mouse in a circle around the joint axis to rotate the joint.

Robot/Object Edges Visibility: Show or hide Robot/Object Edges.

Close Application

Close Application - Exit the application with the option to save or not save a project.

Edit Menu

Undo

Undo (Ctrl+Z) undoes your last action. Note that Undo is available for most – but not all – actions.

Redo

Redo (Ctrl+Shift+Z) – Redo an action that has been undone.

Cut

Cut (Ctrl+X) – Cut the selected item(s).

Copy

Copy (Ctrl+C) - Copy the selected item(s).

Paste

Paste (Ctrl+V) - Paste an item or items that have been copied or cut.

General Rules for Cut/Copy/Paste

 

  • Any robot and/or object can be copied but the pasted result will be weak-mated.

  • Robots can be copied as a whole object only. However, selecting only links or a robot TCP is enough to trigger the copy of the whole robot.

  • When a robot is being copied, all robot presets that are created for the robot will be copied, with each preset information copied as much is possible, i.e., the robot TCP’s and assigned states will be copied.

  • Unlike robots, part(s) of an object can be copied.

  • Anything that is attached or assigned to copied objects, for example, targets or frames, will also be copied.

  • Frames and targets cannot be copied without the parent item.

  • If copied items have a direct connection between each other, for example, joints or mates, they will be copied as well.

  • In case of mates, all mate states, i.e., object states, will be copied as well.

  • No roadmap data is copied at any time, e.g., target assignments, roadmap connections, and auto-connects cannot be copied.

  • Disable collision checking for objects persist in the copied object.

Camera

 

  • Perspective - Option for viewing the workcell in which the objects in the 3D View are presented in two dimensions while still displaying the effect of distance.

  • Orthographic - Option for viewing the workcell in which the parallel lines of the shape of objects in 3D View are depicted as orthogonal (at right angles) to the projection plane.

About

About RapidPlan Create

Displays the version number and build ID for the current RapidPlan Create software.

License Info

Displays information about the license and allows user to install a new license.

 

Mode Selector

Choose here between Model Mode and Roadmap Mode. A new project always begins in Model Mode.

Rules of Mode Transitioning

 

  • RapidPlan Create will display feedback messages when you transition from one mode to the other.

  • The Undo history and copy and paste cache will be preserved.

When Moving from Model Mode to Roadmap Mode

RapidPlan Create will retain or remove target assignments, based on changes made in Model mode regarding:

  • Adding or removing joints

  • Changes to robot presets

  • Any additional kinematic chain/TCP changes on a given robot

  • When the relative offset between a target and a robot base has changed so the robot configuration can’t reach its target

If there are no changes in the above categories, the target assignments will still be retained.

RapidPlan Create verifies project integrity during the transition. The transition may take some time.

If the project is unfinished under Model Mode, the transition to Roadmap Mode will be disabled. A project is considered unfinished if any of the following are true:

  • Free joints have been assigned without a robot.

  • There are joints with duplicate driver indexes.

  • There are objects/robots that are not mated to the world.

When Moving from Roadmap Mode to Model Mode

There is no restriction moving from Roadmap Mode to Model Mode. However, all validation states will be reset and auto-connects are invalidated during the transition. Once back to Roadmap mode, all roadmaps must be re-validated and this change may result in different generated paths based on the previous changes.

To ensure motion paths are maintained the same during transition, convert auto-connects to targets and direct connections.

Tool Bar

 

Quick-access pushbuttons are arranged from left to right, based on the sequence of the workflow in Model Mode or in Roadmap Mode of RapidPlan Create.

Toolbar in Model Mode

 

 

Much of the creation, modifying, and measuring of the workcell starts here. The Tool Bar contains buttons for adding robots and robot presets, objects and object states, setting robot dynamics, creating mates, joints, frames, a tool for taking measurements of the model, and tool for disabling collision checks for static objects.

Toolbar in Roadmap Mode

 

Much of the robots' target management and robots' motion planning starts here. The Tool Bar contains target creation, target sequencing, and target assignment functions; and inspection and validation of the collision-free robot motion planning. You can also modify collision checking for parts of the project export the final workcell model project from here.

3D View

 

The interactive view of the workcell where you can see and modify the model in Model mode or build a roadmap in Roadmap mode. Also known as the canvas.

Cursor coordinates

The values in the lower left corner of the 3D View give the current location of the cursor in 3D space.

Frame Rate

The frame rate, aka frame per second that is a metric to indicate amount of images a display can render per second. It is located on the bottom right corner

Collision View

Turning off collision view will disable the animation of collision rendering (red in color). For more information, see Model Mode | Collision View

 

The Property Tree

The components of the workcell model (robots, objects, mates, targets, etc.) are listed here. You can select items, display more details, and delete or edit items.

Only items that are allowed in the current mode are accessible in the property tree.

The property tree view can be filtered based on texts in the search box.

 

Expand/Reduce

 

Press “>” on the left of an object from the property tree to expand.

Press “V” on the left of an object from the property tree to reduce.

Visibility

 

You can change the level of visibility for items in the 3D View.

Context Menus

 

Context menus are displayed when you right-click on an item in the property tree. These submenus differ depending on what has been selected. Specific options are illustrated below, for each type of item in the property tree.)

Workcell

 

The workcell is made up of the origin and the floor. The origin is the root of the workcell; everything needs to be attached to, or defined by, the transforms of this point in space.

General Context Items

 

Undo - Undoes the last action. (Available for most but not all actions.)

Undo Set Visibility - Undoes the way the current visibility for the item is set.

Cut (Ctrl+X) - Cuts the selected item.

Copy (Ctrl+C) - Copies the selected item.

Paste(Ctrl+V) - Pastes an item that has been copy or cut.

Zoom to fit - Zooms the 3D View to focus on the origin.

Hide <name> - Hides the display of the property tree items in the 3D View.

Show only <name> - Only the selected property item is displayed in the 3D View.

Delete <name> - Deletes the named property tree item.

Rename <name> - Enters a new name for the selected object.

Edit <name> - Displays the Edit dialog for the named object.

Origin

 

Visibility (eye) Icon Behavior on Origin:

  • Visible =Visibility(eye) icon displayed on hover

  • Hidden =Visibility(eye) icon displayed fulltime

Context Menu

Floor

Visibility (eye) Icon Behavior on Floor:

  • Visible =Visibility (eye) icon displayed on hover

  • Hidden =Visibility (eye) icon displayed fulltime

Context Menu

Edit Floor

Displays the Edit Floor dialog.

You can adjust the size of the floor and its grid using Step Count and Step Size, in X and Y directions.

Robots

The names of robots that are not yet mated are displayed in the Property Tree in blue text. When mated, the names display in black text.

Links

Links are the parts of the robot arm connected by joints. Joints allow the links to move.

Base

The robot base is the local origin frame of an object/link that has the first robot joint as a parent. The base of a robot can be moveable or non-moveable, depending on the robot’s kinematic chain. A linear rail is an example of a moveable robot base.

Default_TCP

The default Tool Center Point for the robot, provided by the robot’s manufacturer. The TCP is a special frame often positioned at the robot's end-effector, which is usually the tip of a gripper or welding tool.

  • Robot TCP may be reset to default TCP after changing a frame parent that has tcp as descendant

  • Robot TCP may be reset to default TCP after changing a mate parent that has tcp as descendant

Context Menu

Active Preset - Choose from among the robot presets in the submenu which is the active preset.

Objects

An object is any 3D model in the workcell that represents an obstacle that robots need to avoid (walls, boxes, etc). Objects can be simple primitives like cubes, cylinders, or spheres, or CAD models (stl, step, stp, dae files). End of arm tooling, for example, a gripper or weld gun, is also an object.

The names of objects that are not yet mated are displayed in the Property Tree in blue text. When mated, the names display in black text.