.. _package-rst-kinematics:
========================
Package rst.kinematics
========================
Kinematics is the branch of classical mechanics that describes the
motion of bodies (objects) and systems (groups of objects) without
consideration of the forces that cause the motion.
.. seealso::
Wikipedia article containing the definition above
http://en.wikipedia.org/wiki/Kinematics
Messages
========
.. container:: mess4ge-multi
.. container:: mess4ge-graph
.. digraph:: message_graph
fontname="Arial";
fontsize=11;
stylesheet="../_static/corlab.css";
node [fontsize=11]
node [fontname="Arial"]
edge [fontsize=11]
edge [fontname="Arial"]
"4" [label=<
| ObjectCollision |
|
CollisionGeometry | geometry |
ASCII-STRING | object_1 |
ASCII-STRING | object_2 |
>,shape=box,style=filled,fillcolor="white"];
"5" [label=< | CollisionGeometry |
|
Translation | contact_points |
>,shape=box,style=filled,fillcolor="white"];
"3" [label=< | JointAngles |
|
FLOAT32 | angles |
>,shape=box,style=filled,fillcolor="white"];
"1" [label=< | Posture3DFloat |
|
Translation | position |
>,shape=box,style=filled,fillcolor="white"];
"2" [label=< | Translation |
|
FLOAT64 | x |
FLOAT64 | y |
FLOAT64 | z |
ASCII-STRING | frame_id |
>,shape=box,style=filled,fillcolor="white"];
"4":geometry -> "5" [];
"5":contact_points -> "2" [];
"1":position -> "2" [];
.. container:: mess4ge-list
.. container:: messages
* :ref:`Posture3DFloat `
* :ref:`JointAngles `
* :ref:`ObjectCollision `
* :ref:`CollisionGeometry `
.. container:: clearer
clearer: should be made invisible via css
.. _message-rst-kinematics-posture3dfloat:
Message Posture3DFloat
----------------------
.. container:: message-rst-kinematics-posture3dfloat-multi
.. container:: message-rst-kinematics-posture3dfloat-documentation
.. py:class:: rst.kinematics.Posture3DFloat
A set of positions forming a posture of an articulated thing.
The kinematic structure, which in most cases is required for a
useful interpretation, has to be transmitted through other
channels.
.. codeauthor:: Jan Moringen
.. py:attribute:: position
:type: array of :py:class:`rst.geometry.Translation`
Sequence of joint positions in three-dimensional space.
Interpretation depends on information transmitted trough other
channels.
The order of entries is significant since the interpretations
of individual positions depends on their respective position
within the sequence.
.. container:: message-rst-kinematics-posture3dfloat-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/Posture3DFloat.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/Posture3DFloat.proto
:lines: 16-30
:language: protobuf
:emphasize-lines: 13-13
.. _message-rst-kinematics-jointangles:
Message JointAngles
-------------------
.. container:: message-rst-kinematics-jointangles-multi
.. container:: message-rst-kinematics-jointangles-documentation
.. py:class:: rst.kinematics.JointAngles
Joint angles of a set of multiple joints.
.. codeauthor:: Arne Nordmann
.. py:attribute:: angles
:type: array of :py:class:`FLOAT32`
**Unit**: radian
Joint angles
.. container:: message-rst-kinematics-jointangles-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/JointAngles.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/JointAngles.proto
:lines: 10-18
:language: protobuf
:emphasize-lines: 7-7
.. _message-rst-kinematics-objectcollision:
Message ObjectCollision
-----------------------
.. container:: message-rst-kinematics-objectcollision-multi
.. container:: message-rst-kinematics-objectcollision-documentation
.. py:class:: rst.kinematics.ObjectCollision
Holds information about a collision between two objects.
.. codeauthor:: Daniel Seidel
.. py:attribute:: geometry
:type: :py:class:`rst.kinematics.CollisionGeometry`
Geometry of the collision, such as list of contact points.
.. py:attribute:: object_1
:type: :py:class:`ASCII-STRING`
Name of the first object involved in the collision.
.. py:attribute:: object_2
:type: :py:class:`ASCII-STRING`
Name of the second object involved in the collision.
.. container:: message-rst-kinematics-objectcollision-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/ObjectCollision.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/ObjectCollision.proto
:lines: 12-29
:language: protobuf
:emphasize-lines: 6-6,11-11,16-16
.. _message-rst-kinematics-collisiongeometry:
Message CollisionGeometry
-------------------------
.. container:: message-rst-kinematics-collisiongeometry-multi
.. container:: message-rst-kinematics-collisiongeometry-documentation
.. py:class:: rst.kinematics.CollisionGeometry
Geometric description of a collision between objects.
.. codeauthor:: Daniel Seidel
.. py:attribute:: contact_points
:type: array of :py:class:`rst.geometry.Translation`
**Constraint**: ``len(value) > 0``
Contact points of the collision in world coordinate system.
Order of contact points is not significant.
.. container:: message-rst-kinematics-collisiongeometry-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/CollisionGeometry.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/kinematics/CollisionGeometry.proto
:lines: 12-22
:language: protobuf
:emphasize-lines: 9-9