Couplers

1. From the Project Browser, select the system to which the coupler is to be added.
2. Right-click on a system in the Project Browser and select Add > Constraint > Coupler from the context menu.
   OR
   Right-click on a coupler folder in the Project Browser and select Add Coupler from the context menu.
   OR
   Right-click the Coupler button on the Constraint toolbar.
   The Add Coupler or CouplerPair dialog is displayed.
3. Specify a label and variable name.
   By default, variables names of entities in MotionView follow a certain convention. For example, all coupler entities have a variable name starting with “c_”. This is the recommended convention to follow when building models in MotionView since it has many advantages in model editing and model manipulation.
4. Select whether to create a single coupler or a coupler pair.
   A coupler entity, like most of the entities that are created in MotionView, can be a single entity or a pair entity. Pair entities help in creating models which have symmetric properties.
5. Click OK to close the window or Apply to continue creating entities.
   Once a coupler entity has been added to the model, the panel for the coupler will automatically be displayed in the panel area.

1. If the Couplers panel is not currently displayed, select the desired coupler by clicking on it in the Project Browser or in the modeling window.
   The Couplers panel is automatically displayed.
2. Select the number of joints to constrain.
   Note: If the selected coupler is a pair entity, first distinguish between the Left and Right tabs in the panel, and then edit the properties. When defining a pair coupler, use pair entities for the joints.

   Tip: Check the Symmetric properties option to make the coupler properties symmetric. Once this option is activated, MotionView will ask you which side of the values of the pair entity (left or right) is to be used. Selecting any one side will make values of that side as “master” and the values of the other side will gray out and follow the values on the master side.
3. Click on the Joint 1 collector and pick the desired joint from the modeling window, or double-click the collector to open the Model Tree (from which the desired joint can be selected).
4. In the same manner, click the Joint 2 collector and pick the second joint for the coupler.
5. If the number of joints to constrain is set to 3, repeat the same step for the Joint 3 collector.
   Note: If any of the joints are cylindrical, select the type of the displacement to be controlled by using the drop-down menus located to the right of each selected joint on the panel (translational or rotational).
6. Click the Properties tab.
7. In the case of a two joint coupler, type in the displacement ratio between joint one and joint two in the appropriate box. In the case of a three joint coupler, type in the two displacement ratios between joint one and joint two, and between joint two and joint three.

If desired, define the coupler using the User-Defined tab, which will allow you to specify the properties of the coupler using user subroutines.

1. From the Connectivity tab, click the User-defined properties check box.
   The Properties tab is removed.
2. Click the newly added User-Defined tab.
3. Define the user subroutine.
   1. Provide an expression with the USER solver function with parameters being passed to the user subroutine.
   2. Alternatively, activate the Use local file and function name check box to specify a local file where the subroutine code can be accessed by the solver.
      If this option is not specified, MotionSolve will search for a subroutine following its user subroutine loading rules.
   3. Select a function type from the drop-down menu.
   4. Select the local file for the subroutine.
      The type of file to be specified will depend on the selected function type. For example, if DLL/SO is selected, you can specify a file with a .dll extension (for Windows) or an .so extension (for Linux).
   5. Specify the function name in the subroutine that defines the entity, or accept the default name provided by MotionView.