Provided by: linuxcnc-uspace_2.9.0~pre1+git20230208.f1270d6ed7-1_amd64 bug

NAME

       rosekins - Kinematics for a rose engine

SYNOPSIS

       loadrt rosekins

KINEMATICS

          joint_0 linear, transverse   (perpendicular to spindle)
          joint_1 linear, longitudinal (parallel to spindle identity to z)
          joint_2  rotary,  spindle       (workholding,  not  tool  holding, e.g. not a highspeed
       spindle)

PINS

       rosekins.revolutions float out
              Count  of  crossings  of  the  negative  X  axis.   Clockwise  crossings  increment
              revolutions by 1, Counterclockwise crossings decrement by 1.

       rosekins.theta_degrees float out
              Principal value for arctan(Y/X)

       rosekins.bigtheta_degrees float out
              Accumulated angle (theta + revolutions * 360)

NOTES

       Theta  is  the  principal  value  of arctan(Y/X).  Joint_2 angle values are not limited to
       principal values of arctan(Y/X) but accumulate continuously as  the  spindle  is  rotated.
       HAL pins are provided for the principal value and a count of the number of revolutions.

       The  transverse  motion  is  exactly  perpendicular to the spindle.  In a traditional rose
       engine, the transverse motion is created by 'rocking' the  headstock  about  a  pivot.   A
       typical  pivot  length combined with the limited amount of X travel in a real machine make
       the perpendicular approximation a reasonable model.