KineoWorks step-by-step #2: building your robot with Kwik

KineoWorks is a software component that automatically computes collision-free motion by solving complex path-planning problems in applications such as robotic collision-free trajectory optimization. In this series of articles, Etienne Ferré, Development Director of Kineo components, describes some of the key steps that are easily implemented to develop a sophisticated robotics simulation. In part 1 of our series, we discussed path planning. This article explains how you can easily develop a virtual robot.

Part 2: Building your robot with Kwik

KineoWorks comes with a very complete and powerful API for creating robots and other kinds of kinematic systems. However, for complex kinematics, manipulating geometric features using an API can be a very difficult and error-prone task due to the lack of immediate feedback. For this reason, Kineo offers a much more intuitive and rewarding way to model kinematic systems. It’s an interactive graphical editor called Kwik (KineoWorks Interactive Kinematics) and as the name suggests – it’s the fast way to build your robot.


The following diagram summarizes the workflow for robot modeling. You can use a similar workflow for modeling other kinds of systems.

Building your robot - Kwik workflow

Robot Modeling Steps

Here is a step-by-step procedure for modeling a robot with Kwik:

  • Gather technical data from the robot manufacturer’s website:
    • CAD files for robot geometry
    • Technical specifications (dimensions, axis bounds, axis directions, …)
  • Use Kwik to model the kinematic chain, then import CAD data and attach CAD to kinematics
  • Import any geometries you need to represent the operating environment
  • Model any auxilliary systems (external axis, articulated tool, …)
  • Perform additional application-specific setup such as collision detection
  • Export your data as a Kineo XML file
  • Make this file a resource of your application
  • Use the Kineo API to import the data into your application

You can use the full KineoWorks API to perform any additional setup that Kwik does not currently support.

Example: Modeling a 6-axis ABB Robot

This section illustrates the complete modeling of the ABB IRB 2600 1.65 robot. You can use the same instructions to model any other standard 6-axis robot. With minor changes, you can also model any other kind of kinematic system.

Downloading Data from the Robot Manufacturer’s Website

Most robot manufacturers publish robot specifications and CAD models on their website. You can find the ABB IRC 2600 robot product page on the web, which provides links to technical data and CAD models:

ABB IRB 2600 product page

Kwik imports geometrical data in many formats including JT, STL, VRML, STEP, CATIA V5. Select your choice of supported format. For instance, you might choose the STEP format:

IRB 2600 CAD models

You should also download the technical specifications PDF:

IRB 2600 technical spec

Importing CAD Data into Kwik

First, start Kwik.

In the toolbar, click the Import icon (or choose File > Import):

Building your robot - Kwik file import method

From the unzipped archive that contains the downloaded CAD data, select relevant geometry. In this example, import the base of the robot and its 6 axes. You will not require the working space and flexible cables:

Kwik CAD import method

Imported geometries are listed under Obstacles and displayed in the 3D view:

Building your robot - Kwik 3D view

Modeling Kinematics

From the Insert menu, choose 6-axis robot:

Kwik kinematics model type

This creates a template for standard 6-axis robot kinematics. Joints are displayed as blue cylinders and lines in the 3D view:

Kwik kinematics display

The template dimensions are arbitrary so you must edit them to match your particular robot. To edit joint positions, first select the robot in the Device Editor. The Device Editor displays data for all robot axes in a single place:

Building your robot - Kwik kinematics device editor

You will find the correct dimensions in the specifications PDF:

Building your robot - IRB 2600 spec sheet

Just copy them to the Device Editor:

Building your robot - Kwik device editor axes

You can perform a quick visual check to verify that the values are correct. Choose Camera > Change orientation to > Front (or hit F). You should see that the joints align well with the geometry:

Building your robot - Kwik kinematics visual check

You can also choose Camera > Change orientation to > Left (or hit L) to check that the joints are at the same depth as the geometry.

Attaching Geometry to Axes

The imported geometries and kinematics model are currently independent from each other so you need to link them.

Click the + button next to the robot to display its axes:

Building your robot - Kwik kinematics geometry axes display

Drag each imported geometry from the Obstacles section to its corresponding axis (BASE -> Base, LINK1 -> Axis 1, etc.)

Kwik kinematics move geometry to axes

Your document should now look like this:

Kwik kinematics geometry axes linkage

You can verify the correct linkage of geometries and axes visually by jogging the degrees of freedom of the robot.

Kwik geometry axes visual verification

Exporting the Robot

Once a robot has been modeled in Kwik, you can export (i.e. serialize) it to an XML file that you can package as a resource of your application and import using the KineoWorks API.

Firstly, Select the robot to export and click the Export button in the toolbar (or choose File > Export). Secondly, Choose a name for the file. You can use .kwd for devices (including systems and robots), .kws for systems (including robots) and .kwr for robots. Select .kwr in order to make it clear that the XML file describes a robot and not some other device.

The file is written to disk. At the same time, source code is copied to the system clipboard which you can paste into your code editor:

Kwik robot source code

The source code enables you to retrieve the robot as an object using the KineoWorks C++ or C# API.

In part 3 of our series, we’ll take a closer look at how you can control the motion of the robot and explore the difference between a path and a trajectory.

Leave a Reply