Robot Workbench/sv: Difference between revisions
Renatorivo (talk | contribs) No edit summary |
(Updating to match new version of source page) |
||
Line 1: | Line 1: | ||
Robot arbetsbänken är ett verktyg för simulering av 6-axliga industrirobotar, som t.ex. [http://kuka.com/ Kuka]. |
|||
== Allmänt bruk == |
|||
[[Image:KukaKR16FreeCAD.jpg|right|400px]] |
[[Image:KukaKR16FreeCAD.jpg|right|400px]] |
||
The robot workbench is a tool to simulate industrial grade [[6-Axis Robot]]s, like e.g. [http://kuka.com/ Kuka]. |
|||
Denna arbetsbänk är ett pågående arbete för att implementera ett off-line programmeringsverktyg för [[6-Axis Robot]] industrirobotar i FreeCAD. |
|||
You can do following tasks: |
|||
* set up a simulation environment with a robot and work pieces |
|||
* create and fill up trajectories |
|||
* decompose features of an CAD part to a trajectory |
|||
* simulate the robot movement and reachability |
|||
* export the trajectory to a robot program file |
|||
An examples you can find here: |
|||
Du kan hitta ett exempel här: |
|||
⚫ | |||
the [[Robot tutorial]]. |
|||
== Tools == |
|||
⚫ | |||
Here the principal commands you can use to create a robot set-up. |
|||
== |
=== Robots === |
||
The tools to create and manage the 6-Axis robots |
|||
* [[Image:Robot_CreateRobot.png|30px]] [[Robot_CreateRobot|Create a robot]]: Insert a new robot into the scene |
|||
* [[Image:Robot_Simulate.png|30px]] [[Robot_Simulate|Simulate a trajectory]]: Opens the simulation dialog and let you simulate |
|||
* [[Image:Robot_Export.png|30px]] [[Robot_Export|Export a trajectory]]: Export a robot program file |
|||
* [[Image:Robot_SetHomePos.png|30px]] [[Robot_SetHomePos|Set home positon]]: Set the home position of an robot |
|||
* [[Image:Robot_RestoreHomePos.png|30px]] [[Robot_RestoreHomePos|Restore home positon]]: move the robot to its home position |
|||
== |
=== Trajectories === |
||
Tools to creat and manipulate trajectories. There are two kinds, the parametric and non parametric ones. |
|||
==== non parametric ==== |
|||
⚫ | |||
* [[Image:Robot_CreateTrajectory.png|30px]] [[Robot_CreateTrajectory|Create a trajectory]]: Insert a new robot into the scene |
|||
Du kan använda den filen direkt, om du vill. |
|||
* [[Image:Robot_SetDefaultOrientation.png|30px]] [[Robot_SetDefaultOrientation|Set the default orientation]]: Set the orientation way-points gets created by default |
|||
* [[Image:Robot_SetDefaultValues.png|30px]] [[Robot_SetDefaultValues|Set the default speed parameter]]: set the defaults for way-point creation |
|||
* [[Image:Robot_InsertWaypoint.png|30px]] [[Robot_InsertWaypoint|Insert a waypoint]]: Insert a way-point from the current robot position into a trajectory |
|||
* [[Image:Robot_InsertWaypointPre.png|30px]] [[Robot_InsertWaypointPre|Insert a waypoint]]: Insert a way-point from the current mouse position into a trajectory |
|||
==== parametric ==== |
|||
Exempel på hur man använder klassen Robot6Axis, vilken representerar en 6-axlig |
|||
* [[Image:Robot_Edge2Trac.png|30px]] [[Robot_Edge2Trac|Create a trajectory out of edges]]: Insert a new object which decompose edges to a trajectory |
|||
industrirobot. Robot modulen beror på Delmodulen, men inte på andra modulen. |
|||
* [[Image:Robot_TrajectoryDressUp.png|30px]] [[Robot_TrajectoryDressUp|Dress-up a trajectory]]: Let you override one or more properties of a trajectory |
|||
Den arbetar mest med enkla typer som Placering, Vektor och Matris. Så vi behöver |
|||
* [[Image:Robot_TrajectoryCompound.png|30px]] [[Robot_TrajectoryCompound|Trajectory compound]]: create a compound out of some single trajectories |
|||
bara: |
|||
== Scripting == |
|||
⚫ | |||
You can use this file directly if you want. |
|||
Example how to use the basic robot class Robot6Axis which represents a 6-axis |
|||
industrial robot. The Robot module is dependent on Part but not on other modules. |
|||
It works mostly with the basic types Placement, Vector and Matrix. So we need |
|||
only: |
|||
from Robot import * |
from Robot import * |
||
from Part import * |
from Part import * |
||
from FreeCAD import * |
from FreeCAD import * |
||
=== |
=== Basic robot stuff === |
||
create the robot. If you do not specify another kinematic it becomes a Puma 560 |
|||
rob = Robot6Axis() |
rob = Robot6Axis() |
||
print rob |
print rob |
||
accessing the axis and the Tcp. Axes go from 1-6 and are in degree: |
|||
komma åt axlarna och tcp (verktygets centrumpunkt). Axlarna är 1-6 och värdena uttrycks i grader: |
|||
Start = rob.Tcp |
Start = rob.Tcp |
||
print Start |
print Start |
||
print rob.Axis1 |
print rob.Axis1 |
||
move the first axis of the robot: |
|||
flytta robotens första axel: |
|||
rob.Axis1 = 5.0 |
rob.Axis1 = 5.0 |
||
the Tcp has changed (forward kinematic) |
|||
Tcp har ändrats (framåtgående kinematik) |
|||
print rob.Tcp |
print rob.Tcp |
||
move the robot back to start position (reverse kinematic): |
|||
flytta tillbaka roboten till startpositionen (bakåtgående kinematik): |
|||
rob.Tcp = Start |
rob.Tcp = Start |
||
print rob.Axis1 |
print rob.Axis1 |
||
the same with axis 2: |
|||
rob.Axis2 = 5.0 |
rob.Axis2 = 5.0 |
||
print rob.Tcp |
print rob.Tcp |
||
Line 51: | Line 77: | ||
print rob.Axis2 |
print rob.Axis2 |
||
Waypoints: |
|||
Banpunkter: |
|||
w = Waypoint(Placement(),name="Pt",type="LIN") |
w = Waypoint(Placement(),name="Pt",type="LIN") |
||
print w.Name,w.Type,w.Pos,w.Cont,w.Velocity,w.Base,w.Tool |
print w.Name,w.Type,w.Pos,w.Cont,w.Velocity,w.Base,w.Tool |
||
generate more. The trajectory always finds automatically a unique name for the waypoints |
|||
generera mer. Banan hittar alltid automatiskt på ett unikt namn för banpunkterna |
|||
l = [w] |
l = [w] |
||
for i in range(5): |
for i in range(5): |
||
l.append(Waypoint(Placement(Vector(0,0,i*100),Vector(1,0,0),0),"LIN","Pt")) |
l.append(Waypoint(Placement(Vector(0,0,i*100),Vector(1,0,0),0),"LIN","Pt")) |
||
create a trajectory |
|||
Skapa en bana |
|||
t = Trajectory(l) |
t = Trajectory(l) |
||
print t |
print t |
||
Line 66: | Line 92: | ||
t.insertWaypoints(Waypoint(Placement(Vector(0,0,i*100+500),Vector(1,0,0),0),"LIN","Pt")) |
t.insertWaypoints(Waypoint(Placement(Vector(0,0,i*100+500),Vector(1,0,0),0),"LIN","Pt")) |
||
see a list of all waypoints: |
|||
se en lista på alla banpunkter: |
|||
print t.Waypoints |
print t.Waypoints |
||
del rob,Start,t,l,w |
del rob,Start,t,l,w |
||
=== |
=== working with the document === |
||
Working with the robot document objects: |
|||
Arbeta med robotdokument objekten: |
|||
first create a robot in the active document |
|||
if(App.activeDocument() == None):App.newDocument() |
if(App.activeDocument() == None):App.newDocument() |
||
App.activeDocument().addObject("Robot::RobotObject","Robot") |
App.activeDocument().addObject("Robot::RobotObject","Robot") |
||
Define the visual representation and the kinematic definition (see [[6-Axis Robot]] and [[VRML Preparation for Robot Simulation]] for details about that) |
|||
Definiera den visuella representationen och den kinematiska definitionen (se [[6-Axis Robot/sv]] för detaljer om det) |
|||
App.activeDocument().Robot.RobotVrmlFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.wrl" |
App.activeDocument().Robot.RobotVrmlFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.wrl" |
||
App.activeDocument().Robot.RobotKinematicFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.csv" |
App.activeDocument().Robot.RobotKinematicFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.csv" |
||
start positon of the Axis (only that which differ from 0) |
|||
Axelns startpositon (endast om det skiljer sig från 0) |
|||
App.activeDocument().Robot.Axis2 = -90 |
App.activeDocument().Robot.Axis2 = -90 |
||
App.activeDocument().Robot.Axis3 = 90 |
App.activeDocument().Robot.Axis3 = 90 |
||
retrieve the Tcp position |
|||
pos = FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp |
pos = FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp |
||
move the robot |
|||
flytta roboten |
|||
pos.move(App.Vector(-10,0,0)) |
pos.move(App.Vector(-10,0,0)) |
||
FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp = pos |
FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp = pos |
||
create an empty Trajectory object in the active document |
|||
skapa ett tomt banobjekt i det aktiva dokumentet |
|||
App.activeDocument().addObject("Robot::TrajectoryObject","Trajectory") |
App.activeDocument().addObject("Robot::TrajectoryObject","Trajectory") |
||
get the Trajectory |
|||
hämta banan |
|||
t = App.activeDocument().Trajectory.Trajectory |
t = App.activeDocument().Trajectory.Trajectory |
||
add the actual TCP position of the robot to the trajectory |
|||
StartTcp = App.activeDocument().Robot.Tcp |
StartTcp = App.activeDocument().Robot.Tcp |
||
t.insertWaypoints(StartTcp) |
t.insertWaypoints(StartTcp) |
||
Line 101: | Line 127: | ||
print App.activeDocument().Trajectory.Trajectory |
print App.activeDocument().Trajectory.Trajectory |
||
insert some more Waypoints and the start point at the end again: |
|||
sätt in några fler banpunkter och startpunkten i slutet igen: |
|||
for i in range(7): |
for i in range(7): |
||
t.insertWaypoints(Waypoint(Placement(Vector(0,1000,i*100+500),Vector(1,0,0),i),"LIN","Pt")) |
t.insertWaypoints(Waypoint(Placement(Vector(0,1000,i*100+500),Vector(1,0,0),i),"LIN","Pt")) |
||
Line 108: | Line 134: | ||
App.activeDocument().Trajectory.Trajectory = t |
App.activeDocument().Trajectory.Trajectory = t |
||
print App.activeDocument().Trajectory.Trajectory |
print App.activeDocument().Trajectory.Trajectory |
||
=== Simulation === |
=== Simulation === |
||
To be done..... ;-) |
|||
=== |
=== Exporting the trajectory === |
||
The trajectory is exported by Python. That means for every control cabinet type there is a post-processor |
|||
Python |
Python module. Here is in detail the Kuka post-processor described |
||
from KukaExporter import ExportCompactSub |
from KukaExporter import ExportCompactSub |
||
ExportCompactSub(App.activeDocument().Robot,App.activeDocument().Trajectory,'D:/Temp/TestOut.src') |
ExportCompactSub(App.activeDocument().Robot,App.activeDocument().Trajectory,'D:/Temp/TestOut.src') |
||
and that's kind of how it's done: |
|||
och det är ungefär så här det görs: |
|||
for w in App.activeDocument().Trajectory.Trajectory.Waypoints: |
for w in App.activeDocument().Trajectory.Trajectory.Waypoints: |
||
(A,B,C) = (w.Pos.Rotation.toEuler()) |
(A,B,C) = (w.Pos.Rotation.toEuler()) |
||
print ("LIN {X %.3f,Y %.3f,Z %.3f,A %.3f,B %.3f,C %.3f} ; %s"%(w.Pos.Base.x,w.Pos.Base.y,w.Pos.Base.z,A,B,C,w.Name)) |
print ("LIN {X %.3f,Y %.3f,Z %.3f,A %.3f,B %.3f,C %.3f} ; %s"%(w.Pos.Base.x,w.Pos.Base.y,w.Pos.Base.z,A,B,C,w.Name)) |
||
== Tutorials == |
|||
⚫ | |||
* [[6-Axis_Robot|6-Axis_Robot]] |
|||
* [[VRML Preparation for Robot Simulation|VRML Preparation for Robot Simulation]] |
|||
⚫ | |||
⚫ | |||
⚫ | |||
<languages/> |
|||
{{languages/sv | {{en|Robot Workbench}} {{es|Robot Workbench/es}} {{fr|Robot Workbench/fr}} {{it|Robot Workbench/it}} {{ru|Robot Workbench/ru}} }} |
Revision as of 17:10, 24 July 2014
The robot workbench is a tool to simulate industrial grade 6-Axis Robots, like e.g. Kuka. You can do following tasks:
- set up a simulation environment with a robot and work pieces
- create and fill up trajectories
- decompose features of an CAD part to a trajectory
- simulate the robot movement and reachability
- export the trajectory to a robot program file
An examples you can find here: Example files or try the Robot tutorial.
Tools
Here the principal commands you can use to create a robot set-up.
Robots
The tools to create and manage the 6-Axis robots
- Create a robot: Insert a new robot into the scene
- Simulate a trajectory: Opens the simulation dialog and let you simulate
- Export a trajectory: Export a robot program file
- Set home positon: Set the home position of an robot
- Restore home positon: move the robot to its home position
Trajectories
Tools to creat and manipulate trajectories. There are two kinds, the parametric and non parametric ones.
non parametric
- Create a trajectory: Insert a new robot into the scene
- Set the default orientation: Set the orientation way-points gets created by default
- Set the default speed parameter: set the defaults for way-point creation
- Insert a waypoint: Insert a way-point from the current robot position into a trajectory
- Insert a waypoint: Insert a way-point from the current mouse position into a trajectory
parametric
- Create a trajectory out of edges: Insert a new object which decompose edges to a trajectory
- Dress-up a trajectory: Let you override one or more properties of a trajectory
- Trajectory compound: create a compound out of some single trajectories
Scripting
This section is generated out of: http://sourceforge.net/p/free-cad/code/ci/master/tree/src/Mod/Robot/RobotExample.py You can use this file directly if you want.
Example how to use the basic robot class Robot6Axis which represents a 6-axis industrial robot. The Robot module is dependent on Part but not on other modules. It works mostly with the basic types Placement, Vector and Matrix. So we need only:
from Robot import * from Part import * from FreeCAD import *
Basic robot stuff
create the robot. If you do not specify another kinematic it becomes a Puma 560
rob = Robot6Axis() print rob
accessing the axis and the Tcp. Axes go from 1-6 and are in degree:
Start = rob.Tcp print Start print rob.Axis1
move the first axis of the robot:
rob.Axis1 = 5.0
the Tcp has changed (forward kinematic)
print rob.Tcp
move the robot back to start position (reverse kinematic):
rob.Tcp = Start print rob.Axis1
the same with axis 2:
rob.Axis2 = 5.0 print rob.Tcp rob.Tcp = Start print rob.Axis2
Waypoints:
w = Waypoint(Placement(),name="Pt",type="LIN") print w.Name,w.Type,w.Pos,w.Cont,w.Velocity,w.Base,w.Tool
generate more. The trajectory always finds automatically a unique name for the waypoints
l = [w] for i in range(5): l.append(Waypoint(Placement(Vector(0,0,i*100),Vector(1,0,0),0),"LIN","Pt"))
create a trajectory
t = Trajectory(l) print t for i in range(7): t.insertWaypoints(Waypoint(Placement(Vector(0,0,i*100+500),Vector(1,0,0),0),"LIN","Pt"))
see a list of all waypoints:
print t.Waypoints del rob,Start,t,l,w
working with the document
Working with the robot document objects: first create a robot in the active document
if(App.activeDocument() == None):App.newDocument() App.activeDocument().addObject("Robot::RobotObject","Robot")
Define the visual representation and the kinematic definition (see 6-Axis Robot and VRML Preparation for Robot Simulation for details about that)
App.activeDocument().Robot.RobotVrmlFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.wrl" App.activeDocument().Robot.RobotKinematicFile = App.getResourceDir()+"Mod/Robot/Lib/Kuka/kr500_1.csv"
start positon of the Axis (only that which differ from 0)
App.activeDocument().Robot.Axis2 = -90 App.activeDocument().Robot.Axis3 = 90
retrieve the Tcp position
pos = FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp
move the robot
pos.move(App.Vector(-10,0,0)) FreeCAD.getDocument("Unnamed").getObject("Robot").Tcp = pos
create an empty Trajectory object in the active document
App.activeDocument().addObject("Robot::TrajectoryObject","Trajectory")
get the Trajectory
t = App.activeDocument().Trajectory.Trajectory
add the actual TCP position of the robot to the trajectory
StartTcp = App.activeDocument().Robot.Tcp t.insertWaypoints(StartTcp) App.activeDocument().Trajectory.Trajectory = t print App.activeDocument().Trajectory.Trajectory
insert some more Waypoints and the start point at the end again:
for i in range(7): t.insertWaypoints(Waypoint(Placement(Vector(0,1000,i*100+500),Vector(1,0,0),i),"LIN","Pt")) t.insertWaypoints(StartTcp) # end point of the trajectory App.activeDocument().Trajectory.Trajectory = t print App.activeDocument().Trajectory.Trajectory
Simulation
To be done..... ;-)
Exporting the trajectory
The trajectory is exported by Python. That means for every control cabinet type there is a post-processor Python module. Here is in detail the Kuka post-processor described
from KukaExporter import ExportCompactSub ExportCompactSub(App.activeDocument().Robot,App.activeDocument().Trajectory,'D:/Temp/TestOut.src')
and that's kind of how it's done:
for w in App.activeDocument().Trajectory.Trajectory.Waypoints: (A,B,C) = (w.Pos.Rotation.toEuler()) print ("LIN {X %.3f,Y %.3f,Z %.3f,A %.3f,B %.3f,C %.3f} ; %s"%(w.Pos.Base.x,w.Pos.Base.y,w.Pos.Base.z,A,B,C,w.Name))
Tutorials