RoboDK API for Python
The robodk
package implements the RoboDK API for Python.
The RoboDK API allows creating simulations for industrial robots, specific mechanisms and generating vendor-specific programs for robots.
With the RoboDK API for Python it is possible to simulate and program any industrial robot using Python programming language.
The RoboDK API provides an alternative to using vendor-specific programming languages.
While RoboDK's graphical user interface can be used to create programs, it is possible to extend the robot controller limitations by using a universal programming language such as Python.
The following page provides an overview of the RoboDK API using Python: https://robodk.com/offline-programming.
The robodk
package is available on PyPi.
RoboDK can be used for a wide range of robot manufacturing applications, such as robot machining, 3D printing, synchronizing multiple robots, pick and place, and so on.
Important: The RoboDK API is not the same as the RoboDK Plug-In interface.
Documentation
The robodk
package includes the following modules:
- The
robolink
module is the link between RoboDK and Python. Any item from the RoboDK item tree can be retrieved. Items are represented by the object Item. An item can be a robot, a reference frame, a tool, an object or a specific project. - The
robomath
module is a robotics toolbox, inspired from Peter Corke's Robotics Toolbox. For instance, matrix operations, projection, timers, etc. - The
robodialogs
module is a dialogs toolbox. For instance, open and save file dialogs, message prompts, etc. - The
robofileio
module is a file operation toolbox. File properties, CSV, FTP, etc. - The
roboapps
module is a RoboDK Apps toolbox. More information can be found in our App loader documentation.
You can find more information about RoboDK API in our documentation.
Requirements
Mac and Linux usually have Python 2 installed by default. Although it is not required, Python 3 can be installed on Linux by typing:
sudo apt-get install pip3
sudo apt-get install idle3
The RoboDK API can be used with a free RoboDK license.
How to install
By default, RoboDK automatically uses the PYTHONPATH
environment variable pointing to the /RoboDK/Python/
folder to search for the robodk
package. Alternatively, you can also install the robodk
package for Python:
# cd path-to-python/Scripts
pip install robodk
RoboDK will automatically install external Python dependencies based on your usage. However, if you do not have an active ethernet connection or wish to install them all at once, you can specify external dependencies (see extras_require in setup.py):
# cd path-to-python/Scripts
pip install robodk[cv,apps,lint]
The Python interpreter and editor used by RoboDK can be set in:
RoboDK - Tools - Options - Python
Example
The following script shows an example that uses the robodk
package for robot simulation and offline programming. For more examples using the API, see our documented examples.
from robodk.robolink import *
from robodk.robomath import *
RDK = Robolink()
robot = RDK.Item('Fanuc LR Mate 200iD', ITEM_TYPE_ROBOT)
target = RDK.Item('Target 1')
target_pose = target.Pose()
xyz_ref = target_pose.Pos()
robot.MoveJ(target)
for i in range(7):
ang = i*2*pi/6
x = xyz_ref[0] + R*cos(ang)
y = xyz_ref[1] + R*sin(ang)
z = xyz_ref[2]
target_pos.setPos([x,y,z])
robot.MoveL(target_pos)
robot.RunCode('Program_Done')
robot.MoveL(target)
Post Processors
The same script used for simulation can be used for robot programming offline. This means a program will be automatically generated for your robot controller to reproduce the movements on the robot.
RoboDK supports a large number of robot controllers and it is easy to include compatibility for new robot controllers using Post Processors.
More information about robot post processors here:
You can find the most up to date list of supported robot controllers in our documentation for Post processors.
- ABB RAPID IRC5: for ABB IRC5 robot controllers
- ABB RAPID S4C: for ABB S4C robot controllers
- Adept Vplus: for Adept V+ programming language
- Allen Bradley Logix5000: for Allen Bradley Logix5000 PLC
- Aubo: for AUBO robot controllers
- CLOOS: for CLOOS robot controllers
- Comau C5G: for Comau C5G robot controllers
- Denso PAC: for Denso RC7 (and older) robot controllers (PAC programming language)
- Denso RC8: for Denso RC8 (and newer) robot controllers (PacScript programming language)
- Dobot: for educational Dobot robots
- Doosan: for Doosan collaborative robots
- Epson: for Epson robot controllers
- Fanuc R30iA: for Fanuc R30iA and R30iB robot controllers
- Fanuc R30iA_Arc: for Fanuc Arc welding
- Fanuc RJ3: for Fanuc RJ3 robot controllers
- GCode BnR: for B&R robot controllers
- GSK: for GSK robots
- HCR: for Hanwha robot controllers
- HIWIN HRSS: for HIWIN robots
- Hyundai: for Hyundai robot controllers
- KAIRO: for Keba Kairo robot controllers
- Kinova: for Kinova robots
- Kawasaki: for Kawasaki AS robot controllers
- KUKA IIWA: for KUKA IIWA sunrise programming in Java
- KUKA KRC2: for KUKA KRC2 robot controllers
- KUKA KRC2_CamRob: for KUKA CamRob milling option
- KUKA KRC2_DAT: for KUKA KRC2 robot controllers including DAT data files
- KUKA KRC4: for KUKA KRC4 robot controllers
- KUKA KRC4_Config: for KUKA KRC4 robot controllers with configuration data in each line
- KUKA KRC4_DAT: for KUKA KRC4 robot controllers including DAT data files
- Mecademic: for Mecademic's script code required by the Meca500 robot
- Mecademic Python: it generates a Python script that can control the Mecademic Meca500 robot remotely.
- Mitsubishi: for Mitsubishi robot controllers
- Motoman/Yaskawa: for different Motoman robot controllers using Inform II and Inform III (JBI)
- Nachi AX FD: for Nachi AX and FD robot controllers
- Omron: for Omron/Techman robot controllers
- OTC: for Daihen OTC robot controllers
- Panasonic: For Panasonic PRG programs (requires Panasonic G2PC tools to compile ASCII files to binary files)
- Precise: for Precise Scara robots
- Robostar: for Robostar robot controllers
- Siasun: for Siasun robot controllers
- Siemens_Sinumerik: for Siemens Sinumerik ROBX robot controller
- Staubli VAL3: to generate Staubli VAL3 robot programs (CS8 controllers and later). It inlines the robot movements.
- Staubli VAL3_Machining: for Staubli VAL3 controllers that have the Machining HSM option.
- Staubli S6: for Staubli S6 robot controllers
- Toshiba: for Toshiba robots
- Techman: for Omron/Techman robot controllers
- Universal Robots: for UR robots, it generates linear movements as pose targets
- Universal Robots URP: for UR robots, it generates a URP that can be loaded and modified in Polyscope (the UR robot controller)
- Universal Robots_RobotiQ: for UR robots including support for RobotiQ gripper
- Universal Robots_MoveP: for UR robots, it generates linear movements as MoveP commands
- Yamaha: for Yamaha robots
App loader Plug-In
Once you have a script working in Python, you can easily set it up as an App using the App loader plugin.
RoboDK Apps allow you to customize the RoboDK environment for simulation and offline programming.
RoboDK Apps can be easily distributed for production. More information here:
Linting (source-code checker)
Pylint is a source-code, bug and quality checker for Python programming. Pylint is integrated by default when using RoboDK's default settings (VScode/VScodium text editor).
If you prefer using other text editors you can use the pylint_robodk module with Pylint for linting. The following argument must be passed to pylint to activate this feature:
--load-plugins=pylint_robodk
More about RoboDK