Package org.robwork.sdurw_models
Class ParallelDevicePtr
- java.lang.Object
-
- org.robwork.sdurw_models.ParallelDevicePtr
-
public class ParallelDevicePtr extends java.lang.Object
Ptr stores a pointer and optionally takes ownership of the value.
-
-
Constructor Summary
Constructors Constructor Description ParallelDevicePtr()
Default constructor yielding a NULL-pointer.ParallelDevicePtr(long cPtr, boolean cMemoryOwn)
ParallelDevicePtr(ParallelDevice ptr)
Do not take ownership of ptr.
ptr can be null.
The constructor is implicit on purpose.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description ParallelDevice
__ref__()
Dereferencing operator.JacobianCalculatorPtr
baseJCend(State state)
DeviceJacobian for the end frame.
By default this method forwards to baseDJframe().JacobianCalculatorPtr
baseJCframe(FrameCPtr frame, State state)
DeviceJacobian for a particular frame.
By default this method forwards to baseDJframes().JacobianCalculatorPtr
baseJCframes(FrameVector frames, State state)
Jacobian
baseJend(State state)
Jacobian
baseJframe(FramePtr frame, State state)
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.Transform3D
baseTend(State state)
Calculates the homogeneous transform from base to the end frame
\robabx{base}{end}{\mathbf{T}}Transform3D
baseTframe(FrameCPtr f, State state)
Calculates the homogeneous transform from base to a frame f
\robabx{b}{f}{\mathbf{T}}ParallelDeviceCPtr
cptr()
void
delete()
ParallelDevice
deref()
The pointer stored in the object.boolean
equals(ParallelDevice p)
Q
getAccelerationLimits()
VectorJoint_p
getActiveJoints()
The active joints of the parallel device.PairQ
getAllBounds()
Get bounds for all joints (includes both active and passive joints).VectorJoint_p
getAllJoints()
Get all joints (both active and passive).Frame
getBase()
PairQ
getBounds()
static long
getCPtr(ParallelDevicePtr obj)
ParallelDevice
getDeref()
Member access operator.long
getDOF()
Frame
getEnd()
long
getFullDOF()
Get the total degrees of freedom for all (active and passive) joints in the
device.Q
getFullQ(State state)
Get the full configuration vector of the device.VectorJoint_p
getJoints()
Get all joints of this deviceVectorParallelDeviceLeg
getJunctions()
Get the junctions of the device.VectorParallelLeg_p
getLegs()
The legs of the parallel device.java.lang.String
getName()
Returns the name of the devicePropertyMap
getPropertyMap()
Q
getQ(State state)
StateStructurePtr
getStateStructure()
Get the state structure.Q
getVelocityLimits()
boolean
isNull()
checks if the pointer is nullboolean
isRegistered()
Check if object has registered its state.boolean
isShared()
check if this Ptr has shared ownership or none
ownershipvoid
registerIn(State state)
initialize this stateless data to a specific statevoid
registerIn(StateStructurePtr state)
register this stateless object in a statestructure.void
setAccelerationLimits(Q acclimits)
void
setBounds(PairQ bounds)
void
setFullQ(Q q, State state)
Set the full configuration of the device.
This sets the joint values directly, and there is no checks or guarantees that the device
will be in a valid connected configuration afterwards.void
setName(java.lang.String name)
Sets the name of the Devicevoid
setQ(Q q, vector_b enabled, State state)
Set only some of the actuated joints.
This version of setQ will only set a subset of the actuated joints.
Based on the value of
q, the function will compute the values for the
unactuated (passive) joints, and the remaining actuated joints.
This is mainly useful for parallel devices that have more controlled joints
than strictly required to make the kinematics determined.
void
setQ(Q q, State state)
The configuration q is the configuration for the actuated joints
of the parallel device.void
setVelocityLimits(Q vellimits)
java.lang.String
toString()
void
unregister()
unregisters all state data of this stateless objectTransform3D
worldTbase(State state)
Calculates the homogeneous transform from world to base \robabx{w}{b}{\mathbf{T}}
-
-
-
Constructor Detail
-
ParallelDevicePtr
public ParallelDevicePtr(long cPtr, boolean cMemoryOwn)
-
ParallelDevicePtr
public ParallelDevicePtr()
Default constructor yielding a NULL-pointer.
-
ParallelDevicePtr
public ParallelDevicePtr(ParallelDevice ptr)
Do not take ownership of ptr.
ptr can be null.
The constructor is implicit on purpose.
-
-
Method Detail
-
getCPtr
public static long getCPtr(ParallelDevicePtr obj)
-
delete
public void delete()
-
deref
public ParallelDevice deref()
The pointer stored in the object.
-
__ref__
public ParallelDevice __ref__()
Dereferencing operator.
-
getDeref
public ParallelDevice getDeref()
Member access operator.
-
equals
public boolean equals(ParallelDevice p)
-
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
-
cptr
public ParallelDeviceCPtr cptr()
-
setQ
public void setQ(Q q, State state)
The configuration q is the configuration for the actuated joints
of the parallel device. Based on the value of q the setQ() method
automatically computes the values for the unactuated (passive)
joints.
-
setQ
public void setQ(Q q, vector_b enabled, State state)
Set only some of the actuated joints.
This version of setQ will only set a subset of the actuated joints.
Based on the value of
q, the function will compute the values for the
unactuated (passive) joints, and the remaining actuated joints.
This is mainly useful for parallel devices that have more controlled joints
than strictly required to make the kinematics determined.
- Parameters:
q
- [in] the configuration of the actuated joints
(the only considered elements are the ones where the corresponding elements of enabled
is true).enabled
- [in] vector of same size as q, specifying which values to solve for.state
- [in/out] the state with all active and passive joint values.
The input state is expected to contain a valid and consistent configuration of the
device.
-
getLegs
public VectorParallelLeg_p getLegs()
The legs of the parallel device.
-
getJunctions
public VectorParallelDeviceLeg getJunctions()
Get the junctions of the device.- Returns:
- a vector of junctions. Each junction is given by a two or more legs.
-
getActiveJoints
public VectorJoint_p getActiveJoints()
The active joints of the parallel device.
-
getAllJoints
public VectorJoint_p getAllJoints()
Get all joints (both active and passive).- Returns:
- a vector of all the joints.
-
getFullDOF
public long getFullDOF()
Get the total degrees of freedom for all (active and passive) joints in the
device.- Returns:
- the total degrees of freedom.
-
getAllBounds
public PairQ getAllBounds()
Get bounds for all joints (includes both active and passive joints).- Returns:
- a pair with the lower and upper limits.
-
getFullQ
public Q getFullQ(State state)
Get the full configuration vector of the device. This gives the complete state of
the parallel device.- Parameters:
state
- [in] the state that contains the full configuration.- Returns:
- the configuration vector with the joint values for both active and passive
joints.
-
setFullQ
public void setFullQ(Q q, State state)
Set the full configuration of the device.
This sets the joint values directly, and there is no checks or guarantees that the device
will be in a valid connected configuration afterwards.- Parameters:
q
- [in] the configuration vector to set.state
- [in/out] the state to update with a new configuration.
-
getJoints
public VectorJoint_p getJoints()
Get all joints of this device- Returns:
- all joints
-
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)
-
baseJCframes
public JacobianCalculatorPtr baseJCframes(FrameVector frames, State state)
-
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 Transform3D baseTframe(FrameCPtr 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 Transform3D 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 Transform3D 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}}
-
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 fromstate
- [in] the state to calculate in- Returns:
- the jacobian
-
baseJCend
public JacobianCalculatorPtr baseJCend(State state)
DeviceJacobian for the end frame.
By default this method forwards to baseDJframe().
-
baseJCframe
public JacobianCalculatorPtr baseJCframe(FrameCPtr frame, State state)
DeviceJacobian for a particular frame.
By default this method forwards to baseDJframes().
-
getPropertyMap
public PropertyMap getPropertyMap()
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
registerIn
public void registerIn(State state)
initialize this stateless data to a specific state- Parameters:
state
- [in] the state in which to register the data.
Note: the data will be registered in the state structure of the state
and any copies or other instances of the state will therefore also
contain the added states.
-
registerIn
public void registerIn(StateStructurePtr state)
register this stateless object in a statestructure.
-
unregister
public void unregister()
unregisters all state data of this stateless object
-
getStateStructure
public StateStructurePtr getStateStructure()
Get the state structure.- Returns:
- the state structure.
-
isRegistered
public boolean isRegistered()
Check if object has registered its state.- Returns:
- true if registered, false otherwise.
-
-