Package org.robwork.sdurw

Class SerialDevicePtr

  • public class SerialDevicePtr
extends java.lang.Object
    Ptr stores a pointer and optionally takes ownership of the value.

    • Constructor Detail

      • SerialDevicePtr

        public SerialDevicePtr​(long cPtr,
                       boolean cMemoryOwn)

      • SerialDevicePtr

        public SerialDevicePtr()
        Default constructor yielding a NULL-pointer.

      • SerialDevicePtr

        public SerialDevicePtr​(SerialDevice ptr)
        Do not take ownership of ptr.

        ptr can be null.

        The constructor is implicit on purpose.

    • Method Detail

      • delete

        public void delete()

      • deref

        public SerialDevice deref()
        The pointer stored in the object.

      • __ref__

        public SerialDevice __ref__()
        Dereferencing operator.

      • getDeref

        public SerialDevice getDeref()
        Member access operator.

      • isShared

        public boolean isShared()
        check if this Ptr has shared ownership or none
        ownership
        Returns:
        true if Ptr has shared ownership, false if it has no ownership.

      • isNull

        public boolean isNull()
        checks if the pointer is null
        Returns:
        Returns true if the pointer is null

      • frames

        public FrameVector frames()
        Frames of the device.

        This method is being used when displaying the kinematic
        structure of devices in RobWorkStudio. The method really
        isn't of much use for everyday programming.

        Returns:
        list of raw Frame pointers.

      • getJoints

        public JointPointerVector getJoints()
        Get all joints of this device
        Returns:
        all joints

      • setQ

        public void setQ​(Q q,
                 State state)

      • getQ

        public Q getQ​(State state)

      • getDOF

        public long getDOF()

      • getBounds

        public PairQ getBounds()

      • setBounds

        public void setBounds​(PairQ bounds)

      • getVelocityLimits

        public Q getVelocityLimits()

      • setVelocityLimits

        public void setVelocityLimits​(Q vellimits)

      • getAccelerationLimits

        public Q getAccelerationLimits()

      • setAccelerationLimits

        public void setAccelerationLimits​(Q acclimits)

      • getBase

        public Frame getBase()

      • getEnd

        public Frame getEnd()

      • getName

        public java.lang.String getName()
        Returns the name of the device
        Returns:
        name of the device

      • setName

        public void setName​(java.lang.String name)
        Sets the name of the Device
        Parameters:
        name - [in] the new name of the frame

      • baseTframe

        public Transform3Dd baseTframe​(Frame f,
                               State state)
        Calculates the homogeneous transform from base to a frame f
        \robabx{b}{f}{\mathbf{T}}
        Returns:
        the homogeneous transform \robabx{b}{f}{\mathbf{T}}

      • baseTend

        public Transform3Dd baseTend​(State state)
        Calculates the homogeneous transform from base to the end frame
        \robabx{base}{end}{\mathbf{T}}
        Returns:
        the homogeneous transform \robabx{base}{end}{\mathbf{T}}

      • worldTbase

        public Transform3Dd worldTbase​(State state)
        Calculates the homogeneous transform from world to base \robabx{w}{b}{\mathbf{T}}

        Returns:
        the homogeneous transform \robabx{w}{b}{\mathbf{T}}

      • baseJframe

        public Jacobian baseJframe​(Frame frame,
                           State state)
        Calculates the jacobian matrix of a frame f described in the
        robot base frame ^{base}_{frame}\mathbf{J}_{\mathbf{q}}(\mathbf{q})

        Parameters:
        frame - [in] Frame for which to calculate the Jacobian
        state - [in] State for which to calculate the Jacobian

        Returns:
        the 6*ndof jacobian matrix: {^{base}_{frame}}\mathbf{J}_{\mathbf{q}}(\mathbf{q})

        This method calculates the jacobian relating joint velocities ( \mathbf{\dot{q}} ) to the frame f velocity seen from base-frame
        ( \nu^{base}_{frame} )

        \nu^{base}_{frame} = {^{base}_{frame}}\mathbf{J}_\mathbf{q}(\mathbf{q})\mathbf{\dot{q}}


        The jacobian matrix {^{base}_n}\mathbf{J}_{\mathbf{q}}(\mathbf{q})
        is defined as:

        {^{base}_n}\mathbf{J}_{\mathbf{q}}(\mathbf{q}) = \frac{\partial ^{base}\mathbf{x}_n}{\partial \mathbf{q}}

        By default the method forwards to baseJframes().

      • baseJframes

        public Jacobian baseJframes​(FrameVector frames,
                            State state)
        The Jacobian for a sequence of frames.

        A Jacobian is computed for each of the frames and the Jacobians are
        stacked on top of eachother.
        Parameters:
        frames - [in] the frames to calculate the frames from
        state - [in] the state to calculate in
        Returns:
        the jacobian

      • getPropertyMap

        public PropertyMap getPropertyMap()
        Miscellaneous properties of the device.

        The property map of the device is provided to let the user store
        various settings for the device. The settings are typically loaded
        from setup files.

        The low-level manipulations of the property map can be cumbersome. To
        ease these manipulations, the PropertyAccessor utility class has been
        provided. Instances of this class are provided for a number of common
        settings, however it is undecided if these properties are a public
        part of RobWork.

        Returns:
        The property map of the device.