Difference between revisions of "MC-Basic:CIRCLE"

From SoftMC-Wiki
Jump to: navigation, search
m (1 revision)
Line 4: Line 4:
  
 
|SYNTAX=
 
|SYNTAX=
Circle ''<group>'' Angle = ''<angle> ''CircleCenter = {''<vector>''}<br>
+
'''Circle''' ''<group>'' '''Angle''' = ''<angle> '''''CircleCenter''' = {''<vector>''}
 
+
{'''CirclePlane''' = ''<circle plane>''} ''{Optional Nodal Property}''*  
{CirclePlane = ''<circle plane>''} ''{Optional Property}''* ''{VelocityFinal ='' ''<value>''}
 
  
 
Or
 
Or
  
Circle ''<group>'' CirclePoint = ''<vector> ''TargetPoint = {''<vector>''}<br>
+
'''Circle''' ''<group>'' '''CirclePoint''' = ''<vector> '''''TargetPoint''' = {''<vector>''}
 
+
{'''CirclePlane''' = ''<circle plane>''} ''{Optional Nodal Property}''*  
{CirclePlane = ''<circle plane>''} ''{Optional Property}''* ''{VelocityFinal ='' ''<value>''}
 
  
 
|AVAILABILITY=
 
|AVAILABILITY=
Line 18: Line 16:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
The CIRCLE command issues a circular path trajectory for the specified group, and uses the properties of that group.
+
The CIRCLE command issues a circular(arc) path trajectory for the specified group/robot, and uses the properties of that group.
 +
 
 +
There are two forms of the  CIRCLE command. One specifies the group name, the angle and the circle center, the other is defined by circle point and the final point of the arc. The first enables multi-turn circular motion while the other does not demand from the user the knowledge of the circle center point.
  
The CIRCLE command specifies the group name, the angle and the circle center. Other properties are optional, and may be selected from the following list:
+
These optional properties override the permanent values of the properties for the duration of the command. When using an optional property, the keyword must be specified.
  
ABSOLUTE<br>
+
In case of robot models the CIRCLE command issues circular path in Cartesian space (XYZ). Orientation angles are interpolated proportionality to the circle angle.
        ACCELERATION<br>
+
 
        ACCELERATIONMAX<br>
+
In PUMA robot the orientation vector is kept orthogonal to the circular path.
        DECELERATION<br>
 
        DECELERATIONMAX<br>
 
        SMOOTHFACTOR<br>
 
        STARTTYPE<br>
 
        VELOCITYCRUISE<br>
 
        VELOCITYMAX
 
  
These optional properties override the permanent values of the properties for the duration of the command. When using an optional property, the keyword must be specified.
 
  
 
|TYPE=
 
|TYPE=
Line 41: Line 34:
 
''<angle>'': +/- MaxDouble
 
''<angle>'': +/- MaxDouble
  
''<circle plane>'': 0 (XY)<br>
+
''<circle plane>'':  
 
 
1 (XZ)<br>
 
  
2 (YZ)
+
* 0 (XY)<br>
 +
* 1 (XZ)<br>
 +
* 2 (YZ)
  
All others: +/- Max Double
 
  
 
|UNITS=
 
|UNITS=

Revision as of 12:45, 27 January 2011

The CIRCLE command issues a circular(arc) path trajectory for the specified group/robot, and uses the properties of that group.

There are two forms of the CIRCLE command. One specifies the group name, the angle and the circle center, the other is defined by circle point and the final point of the arc. The first enables multi-turn circular motion while the other does not demand from the user the knowledge of the circle center point.

These optional properties override the permanent values of the properties for the duration of the command. When using an optional property, the keyword must be specified.

In case of robot models the CIRCLE command issues circular path in Cartesian space (XYZ). Orientation angles are interpolated proportionality to the circle angle.

In PUMA robot the orientation vector is kept orthogonal to the circular path.

Syntax

Circle <group> Angle = <angle> CircleCenter = {<vector>} {CirclePlane = <circle plane>} {Optional Nodal Property}*

Or

Circle <group> CirclePoint = <vector> TargetPoint = {<vector>} {CirclePlane = <circle plane>} {Optional Nodal Property}*

Availability

All versions

Type

Double

Range

<group>: An existing group
<angle>: +/- MaxDouble

<circle plane>:

  • 0 (XY)
  • 1 (XZ)
  • 2 (YZ)

Default

Permanent property values are used unless specified otherwise. Final velocity is 0.

Scope

Task or Terminal

Limitations

Applicable only to groups. A group cannot be moved if an axis from the group is being moved individually. A group must be attached in order to be moved from within a task.

Examples

Circle XYTable Angle = 90 CircleCenter = {20,10} Vcruise = 500

Circle XYtable CirclePoint = {10,20} TargetPoint = {100,200} Vcruise = 500

See Also