Adams Basic Package > Adams View > View Command Language > constraint > constraint modify complex_joint coupler

constraint modify complex_joint coupler

Allows the modification of an existing coupler.

Format:

 
constraint modify complex_joint coupler
coupler_name =
an existing coupler
new_coupler_name =
a new coupler
adams_id =
adams_id
comments =
string
joint_name =
an existing joint
type_of_freedom =
coupler_freedom
motion_multipliers =
real
first_angular_scale_factor =
angle
first_scale_factor =
real
second_angular_scale_factor =
angle
second_scale_factor =
real
third_angular_scale_factor =
angle
third_scale_factor =
real
user_function =
real

Example:

 
constraint modify complex_joint coupler &
coupler_name =
coupler__1 &
new_coupler_name =
coupler__2 &
adams_id =
1 &
comments =
"comment string" &
joint_name =
JOINT_1 , JOINT_1 &
motion_multipliers =
0.1 , 0.2 &
type_of_freedom =
rot_rot_rot

Description:

 
Parameter
Value Type
Description
coupler_name
An Existing Coupler
Specifies the coupler to modify.
new_coupler_name
A New Coupler
Specifies the name of the new coupler.
adams_id
Adams_id
Specifies an integer used to identify this element in the Adams data file.
comments
String
Specifies comments for the object being created or modified.
joint_name
An Existing Joint
Specifies the translational, revolute, or cylindrical joint associated with this entity.
type_of_freedom
Coupler_freedom
Specifies whether cylindrical joints transfer translational or rotational motion.
motion_multipliers
Real
Specifies the relative motion of the joints you identify with JOINTS
first_angular_scale_factor
Angle
Specifies the angular motion of the first joint you identify with JOINT_NAME relative to the motion of the second and third joints you identify with JOINT_NAME.
first_scale_factor
Real
Specifies the non-angular motion of the first joint you identify with JOINT_NAME relative to the motion of the second and third joints you identify with JOINT_NAME.
second_angular_scale_factor
Angle
Specifies the angular motion of the second joint you identify with JOINT_NAME relative to the motion of the first and third joints you identify with JOINT_NAME
second_scale_factor
Real
Specifies the non-angular motion of the second joint you identify with JOINT_NAME relative to the motion of the first and third joints you identify with JOINT_NAME.
third_angular_scale_factor
Angle
Specifies the angular motion of the third joint you identify with JOINT_NAME relative to the motion of the first and second joints you identify with JOINT_NAME.
third_scale_factor
Real
Specifies the non-angular motion of the third joint you identify with JOINT_NAME relative to the motion of the first and second joints you identify with JOINT_NAME.
user_function
Real
Specifies up to 30 values for Adams to pass to a userwritten subroutine.

Extended Definition:

1. A coupler creates the coupling of the translational and/or the rotational motion of two or three joints. With this constraint, you can deliver or relate motion from one area of a mechanism to another. Components whose behavior you might approximate with this statement include combinations of hydraulic generators, motors, and pistons and include flexible, rotational transmission cables.
2. You may identify a coupler by typing its name or by picking it from the screen.
If the coupler is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the coupler is displayed. If you created the coupler by reading an Adams data set, the coupler name is the letters COU followed by the Adams data set coupler ID number. The name of Adams COUPLER/101 is COU101, for example. If you created the coupler during preprocessing, you gave it a name at that time. If a coupler is available by default, you may identify it by entering its name only. If it is not, you must enter its full name. To identify a coupler under a different model, for instance, you may need to enter the model name as well. For example, you may specify coupler 'differential' from model 'test' by entering ".test.differential". You must separate multiple coupler names by commas.
3. Normally, entity names like the coupler name are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be any length. For more information, see Using Extended Names. By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it. Note that you can specify the parentage of an entity (for example, what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may over ride the default parent. In most cases, when creating an entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed. You may, or course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.
4. When you use the FILE ADAMS_DATA_SET WRITE command, Adams View writes an Adams data file for your model. Adams requires that each modeling element be identified by a unique integer identifier. If you use this parameter to specify a non-zero identifier, Adams View will use it in the corresponding statement in the Adams data file. You may also enter zero as an identifier, either explicitly or by default. The next time you write an Adams file, Adams View will replace the zero with a unique, internally-generated identifier. Adams View will permanently store this identifier with the element just as if you had entered it yourself. Normally, you would let all identifiers default to zero, and Adams View would generate the identifiers for you. You are never required to enter a non-zero identifier. You only need to specify it if, for some reason, you wish to control the Adams file output.
5. When an Adams Solver data file (.adm) is read into Adams View, all comments associated with a statement (from the end of the previous statement through the end of the current statement) are stored with the object. Comments in the data file can be associated with model. These comments must follow the title statement and be followed by the comment 'END OF MODEL COMMENTS'. This string must be uppercase. When an Adams Solver data file is written, the comments for an object are written before the statement corresponding to the object.
6. You may identify a joint by typing its name or by picking it from the screen. If the joint is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the joint is displayed. If you created the joint by reading an Adams data set or graphics file, the joint name is the letters JOI followed by the Adams data set joint ID number. The name of Adams JOINT/101 is JOI101, for example. If you created the joint during preprocessing, you gave it a name at that time. If a joint is available by default, you may identify it by entering its name only. If it is not, you must enter its full name. To identify a joint under a model, for instance, you may need to enter the model name as well. For example, you may specify joint 'lower_pivot' in model 'links' by entering ".links.lower_pivot". You must separate multiple joint names by commas. If the joint is visible in one of your views, you may identify it by picking on any of the graphics associated with it. You need not separate multiple joint picks by commas.
7. AdamsAdams assumes that translational joints transfer translational motion and that revolute joints transfer rotational motion. A cylindrical joint permits both translational and rotational motion, however. If your coupler includes cylindrical joints, you must use this parameter to indicate which motion is transferred at each joint.
8. Adams uses the values in the SCALES argument in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J
markers. Suppose you are coupling two joints, and SCALES=1,-2. The equation that relates the two joints is
q1 + (-2 * q2) = 0, or
q1 = 2 * q2.
The displacement (q1) of the I marker with respect to the J marker in the first joint is twice that of the displacement (q2) of the I marker with respect to the J marker in the second joint; the two displacements have the same sign. If you specify two joints in the JOINTS argument, you must specify r2. If you specify only one value, Adams assumes it is r2 and uses the default value of 1 for r1.
9. Adams uses the first_angular_scale_factor (r1) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers. Suppose you are coupling two joints, and r1=1 and r2=-2. The equation that relates the two joints is
q1 + (-2 * q2) = 0, or
q1 = 2 * q2.
The displacement (q1) of the I marker with respect to the J marker in the first joint is twice that of the displacement (q2) of the I marker with respect to the J marker in the second joint; the two displacements have the same sign.
10. Adams uses the first_scale_factor (r1) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers. Suppose you are coupling two joints, and r1=1 and r2=-2. The equation that relates the two joints is
q1 + (-2 * q2) = 0, or
q1 = 2 * q2.
The displacement (q1) of the I marker with respect to the J marker in the first joint is twice that of the displacement (q2) of the I marker with respect to the J marker in the second joint; the two displacements have the same sign.
11. Adams uses the second_angular scale_factor (r2) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers. Suppose you are coupling two joints, and r1=1 and r2=-2. The equation that relates the two joints is
q1 + (-2 * q2) = 0, or
q1 = 2 * q2.
The displacement (q1) of the I marker with respect to the J marker in the first joint is twice that of the displacement (q2) of the I marker with respect to the J marker in the second joint; the two displacements have the same sign.
12. Adams uses the second_scale_factor (r2) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers. Suppose you are coupling two joints, and r1=1 and r2=-2. The equation that relates the two joints is
q1 + (-2 * q2) = 0, or
q1 = 2 * q2.
The displacement (q1) of the I marker with respect to the J marker in the first joint is twice that of the displacement (q2) of the I marker with respect to the J marker in the second joint; the two displacements have the same sign.
13. Adams uses the third_angular_scale_factor (r3) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers.
14. Adams uses the third_scale_factor (r3) in the following equation:
(r1 * q1) + (r2 * q2) + (r3 * q3) = 0,
where r1, r2, and r3 are the scale factors for the three joints and q1, q2, and q3 are the translational or the rotational displacements of the joint I markers with respect to their J markers.
 
Tip:  
1. If you type a "?", Adams View will list the couplers available by default.
2. If the coupler is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
3. You need not separate multiple coupler picks by commas.
4. You use the coupler_name parameter to identify the existing coupler to affect with this command.
5. You may use the new_coupler_name later to refer to this coupler. Adams View will not allow you to have two couplers with the same full name, so you must provide a unique name.
6. Some entities constrain motion at, or are otherwise associated with, specific joints. You use this parameter to identify that joint.
7. See the Adams User's Manual for information on writing user-written subroutines.