Motion
Motion
Class Motion()
Motion(parent='MODEL', name='Motion_n', label='Motion_n', active=True,
use_markers=False, itype='DISP', jt=None, jt_type='TRANS', direction='X', i=None, j=None,
ic_disp=0, ic_vel=0, user=False, usr_sub='`USER()`', local_funcname='MOTSUB',
use_local_dll=False, local_dll='', local_func_type='DLL)A motion is used to apply a motion to a joint or a motion constraint between two markers.
setValue, getAssociatedGraphics
Keyword Arguments
| Argument | Data Type | Description | Default |
|---|---|---|---|
| name | String | The variable name. | Motion_n, for next available integer n. |
| label | String | The descriptive label. | Motion_n, for next available integer n. |
| parent | Object | The parent. | MODEL |
| active | Bool | Used to activate or deactivate this entity. | True |
| use_markers | Bool | Motion between two markers if True, motion to a joint otherwise. | False |
| itype | Enum | The type. One of DISP, VEL or ACCL. | DISP |
| jt | Joint | The joint to which the motion is applied when use_markers is False. | None |
| jt_type | Enum | Applies motion to the translational or rotational degree of freedom when using a cylindrical joint. Takes values TRANS or ROT. | TRANS |
| direction | Enum | The motion direction. One of X, Y, Z for translation along the X, Y, Z axis of Marker 2. One of B1, B2, B3 for rotation along the X, Y, Z axis of Marker 2. | X |
| i | Marker | The first marker, when use_markers is True. | None |
| j | Marker | The second marker, when use_markers is True. | None |
| ic_disp | Double | The initial displacement of the motion when itype is VEL or ACC. | 0 |
| ic_vel | Double | The initial velocity of the motion when itype is ACC. | 0 |
Instances
value (Nonlinear) - Set nonlinear value or solver expression for motion. Defaults to .
Notes
1. The parent parameter can only be initialized by the constructor and should not be modified directly.
2. Only parent can be used as a positional argument in the constructor.
3. Instance is a reference to an entity. You cannot modify an instance, but can modify its properties.
Methods
- getAssociatedGraphics()
-
Get all the graphics that are associated with this object.
Returns:
List of all graphic associated with this motion.
Return type:
(list)
- setValue(name, value)
-
Sets value of an attribute.
Parameters:
name str Name of the attribute. value ** Value of the attribute to be set. Returns:
Returns True if the value was successfully set else False.
Return type:
Bool
Motion Pair
Class MotionPair()
MotionPair(parent='MODEL', name='MotionPair_n', label='MotionPair_n', active=True, sym='NONE')Motion pair containing left and right instances of singles.
Keyword Arguments
| Argument | Data Type | Description | Default |
|---|---|---|---|
| name | String | The variable name. | MotionPair_n, for next available integer n. |
| label | String | The descriptive label. | MotionPair_n, for next available integer n. |
| parent | Object | The parent. | MODEL |
| active | Bool | Defines if entity is activated when True or deactivated when False. | True |
| sym | Enum | The symmetry of pair entity. Takes values 'LEFT' for left entity as leader, 'RIGHT' for right entity as leader or 'NONE' when it is not symmetric. | NONE |
Instances
| Instance | Type | Description |
|---|---|---|
| l | Point | The left motion. |
| r | Point | The right motion. |
Notes
Instance is a reference to an entity. You cannot modify an instance, but can modify its properties.
Examples
========
Create and modify attributes of a Motion.
>>> from hw import mview
>>> #Create body, graphic and joint for visible motion
>>> b1 = mview.Body(inertia_props_from_graphic = True)
>>> g1 = mview.Sphere(origin = 'P_Global_Origin',body = b1)
>>> j1 = mview.Joint(type = 'TransJoint')
>>> j1.setValues(b1 = b1,b2 = 'B_Ground',origin = 'P_Global_Origin',align_meth1 = 'VECTOR',align_vec1 = 'V_Global_Y')
>>> #Create joint based motion and set values
>>> m1 = mview.Motion(name = 'linear_translation')
>>> m1.jt = j1
>>> #Set multiple values at once
>>> m1.value.setValues(type = 'EXPR',expr = "`STEP5(TIME,0,0,3,100)`")
>>> m1.itype = 'DISP'
>>> #Switch to marker based motion with velocity
>>> m1.use_markers = True
>>> m1.itype = 'VEL'
>>> #Directions are 6 DOF: X,Y,Z,B1,B2,B3
>>> m1.direction = 'B1'
>>> m1.i = b1.cm
>>> m1.j = 'Global_Frame'
>>> m1.value.setValues(type = 'LIN',lin = 20)