Overview and Key Concepts
The Apply Kinematics activity adds and runs kinematics on a kinematics data node created by a Create Kinematics activity. These kinematics are used to move objects in 3D space.
Objects can perform one or several movement operations at once by specifying speeds and accelerations/decelerations. The following time-based plot shows two kinematics being performed in sequence:
This time-based plot shows two kinematics that overlap each other:
There are 5 types of kinematics:
- Location - Used to move the location of object in the x, y and z coordinates. Speeds and accelerations/decelerations are defined in model units.
- Rotation - Used to rotate the object along the x, y and z axes. Rotation values are defined in degrees. Speeds are defined as degrees per unit of time. Accelerations/decelerations are defined as degrees per unit of time squared. u
- Turn XY - Used to turn the object a certain angle with a given radius. This turn type will turn the object around the z axis along the XY plane. Units are the same as the Rotation type.
- Turn YZ - Used to turn the object a certain angle with a given radius. This turn type will turn the object around the x axis along the YZ plane. Units are the same as the Rotation type.
- Turn ZX - Used to turn the object a certain angle with a given radius. This turn type will turn the object around the y axis along the ZX plane. Units are the same as the Rotation type.
- None - If none is chosen, no new kinematics will be applied. This will only cause the passed in object to be be updated by the kinematics.
The Apply Kinematics activity only allows one connector out. See Adding and Connecting Activities for more information.
The following image shows properties for the Apply Kinematics activity:
Each of these properties will be explained in the following sections.
Used to change the name of the activity. See Name for more information about this property.
The Font button opens a window to edit the activity's background color and font properties. See Font for more information about this property.
The Statistics button opens the activity's statistics window. See Statistics for more information about this property.
The Data Node property needs to point to a node that has kinematics data on it. This data is created by a Create Kinematics activity.
The Object(s) property specifices which object(s) will be doing the movement. Specify an array of objects to have multiple objects can perform the same movement. activity.
The Type property specifices what type of kinematics will be added to the data node. See Types above for more information.
Offset X, Y, Z Location
The offset location properties specify an offset in the x, y and z locations. This is an offset from the object's current location, not an absolute position.
Offset X, Y, Z Rotation
If the Type is set to Rotation, then the Offset Location properties will appear. These are rotational offset for the x, y and z axes. This is an offset from the object's current rotation, not an absolute rotation. In degrees.
Start Angle X, Y, Z Axis
If the Type is set to one of the Turn tyes, then one of the Start Angle X, Y, Z Axis properties will appear. The start angle of 0 will use the object's initial direction of motion. In degrees.
Turn Angle X, Y, Z Axis
If the Type is set to one of the Turn tyes, then one of the Turn Angle X, Y, Z Axis properties will appear. This is the number of degrees to turn about the axis of rotation.
If the Type is set to one of the Turn tyes, then the Turn Radius property will appear. This is the radius or distance from the center of rotation to turn the object. In length units.
The Target Speed property specifies the target travel/rotation speed for the object. In length per time.
The object's acceleration. In length per time squared.
The object's deceleration. In length per time squared.
The object's starting speed of the kinematics. In length per time.
The object's ending speed of the kinematics. In length per time.
The model start time of the kinematics.
Assigns the model finish time of the applied kinematics. See the Assign To section of Common Properties for more information.
Wait For Finish
If checked the token will remain in the Apply Kinematics activity until the kinematics are finished.