part modify point_mass name_and_position
Allows you to modify an existing point_mass's name and position.
Format:
part modify point_mass name_and_position |
|---|
point_mass_name = | an existing point_mass |
new_point_mass_name = | a new point_mass |
adams_id = | adams_id |
comments = | string |
view_name = | an existing view |
location = | location |
orientation = | orientation |
along_axis_orientation = | location |
in_plane_orientation = | location |
relative_to = | an existing model, part or marker |
exact_coordinates = | exact_coordinates |
Example:
part create point_mass name_and_position & |
|---|
point_mass_name = | point_mass__1 & |
new_point_mass_name = | point_mass__2 & |
adams_id = | 1 & |
comments = | "modifying an existing part" & |
planar = | yes & |
relative_to = | ground |
Description:
Parameter | Value Type | Description |
|---|
point_mass_name | An Existing Point_Mass | Specifies the point_mass to be modified. You use this parameter to identify the existing point_mass to be affected with this command. |
new_point_mass_name | A New Point_Mass | Specifies the name of the new point_mass. You may use this name later to refer to this point_mass. |
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. |
view_name | An Existing View | Specifies the view in which to display this part. |
location | Location | Specifies the location of the origin of a coordinate system (e.g. marker or part). |
orientation | Orientation | Specifies the orientation of a coordinate system (e.g. marker or part) using three rotation angles. |
along_axis_orientation | Location | Specifies the orientation of a coordinate system (e.g. marker or part) by directing one of the axes. Adams View will assign an arbitrary rotation about the axis. |
in_plane_orientation | Location | Specifies the orientation of a coordinate system (e.g. marker or part) by directing one of the axes and locating one of the coordinate planes. |
relative_to | An Exixting Model, Part Or Marker | Specifies the coordinate system that location coordinates and orientation angles correspond to. |
exact_coordinates | Exact_Coordinates | Specifies as many as six part coordinates that Adams is not to change as it solves for the initial conditions. |
Extended Definition:
1. The position of the rigid body part can be broken down into two parts:
location, and orientation.
LOCATION can be specified by supplying three coordinates corresponding two the current coordinate system type. For example, if the current coordinate system type is 'cartesian', you would supply an X, Y, and Z. You may also specify location by "clicking" on an existing part or marker, with the mouse cursor, that has the same desired location.
ORIENTATION can be specified by three different methods in Adams View.
The first is by supplying three angles that correspond to the current orientation type. For example, if the current orientation type is 'body313' you would supply Z,X',Z'' rotation angles. You may also supply three angles by "clicking" on an existing part or marker, that has the same desired orientation. The second method is called the ALONG_AXIS_ORIENTATION. This method specifies the orientation by directing one of the axes. Adams View will assign an arbitrary rotation about that axis. The third and final method is called IN_PLANE_ORIENTATION. This method specifies orientation by directing one of the axes, and locating one of the coordinate planes.
All location and orientation coordinates will be relative to the coordinate system specified in the parameter RELATIVE_TO. RELATIVE_TO defaults to the global origin of the model.
2. You may identify a point_mass by typing its name or by picking it from the screen.
If the point_mass is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the point_mass is displayed.
If you created the point_mass by reading an Adams data set or graphics file, the point_mass name is the letters POI followed by the Adams data set point_mass ID number. For example, the name of Adams POINT_MASS/101 is POI101. If you created the point_mass during preprocessing, you will have given it a name at that time.
If a point_mass 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 point_mass under another model, for instance, you may need to enter the model name as well. For example, you may specify point_mass 'arm' from model 'robot' by entering ".robot.arm". If you type a "?", Adams View will list the point_masss available by default.
You must separate multiple point_mass names by commas.
If the point_mass 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 point_mass picks by commas.
3. Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be of 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 (e.g. 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, of 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 AdamsAdams 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 view by typing its name or by picking it from the screen. In most cases, you may enter the special view name 'all', which means all the views currently displayed.
You must separate multiple view names by commas. You need not separate multiple view picks by commas.
7. By default, you supply Cartesian (x, y, z) coordinates. You may use the 'defaults units coordinate_system_type =' command to change this convention. For example, selecting 'cylindrical' means you will subsequently be supplying r, theta, and z coordinates.
Adams View applies your location coordinates in the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
8. Adams View will orient the coordinate system by starting from the initial coordinate system and applying three successive rotations.
Depending on the convention you have selected, the rotations may occur about space-fixed or body-fixed axes in any meaningful combination of the x, y, and z axes.
By default, you supply Euler (body313, or body-fixed z, x, z) angles.
You may change this convention with the 'DEFAULTS UNITS
ORIENTATION_TYPE=' command. For example, selecting SPACE123 means you will subsequently be supplying space-fixed x, y, and z angles.
Adams View applies your orientation angles starting from the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
9. You may enter either one or two locations for the in_plane_orientation parameter to direct the axis. If you enter one location, the axis will point toward the location. If you specify two locations, the axis will be parallel to, and pointing the same way as, the vector from the first location to the second. Note that this does not completely dictate the orientation of the coordinate system. Adams View will position the coordinate system with an arbitrary rotation about the axis. If you must completely control the coordinate system orientation, use ORIENTATION or IN_PLANE_ORIENTATION.
By default, you direct the Z axis of the coordinate system. You may change this convention with the 'DEFAULTS ORIENT_AXIS_AND_PLANE AXIS_AND_PLANE_SETTING=' command. For example, selecting either X_AXIS_XY_PLANE or X_AXIS_XZ_PLANE means you will subsequently be directing the X axis. The plane-convention setting does not affect this parameter.
Adams View applies your location coordinates in the coordinate system you identify with the RELATIVE_TO parameter. The default for the RELATIVE_TO parameter is the default coordinate system.
10. If the relative_to parameter is not specified, the default coordinate system is used. The default coordinate system is initially your model, that is, the global coordinate system. You may change the default coordinate system using the 'defaults coordinate_system' command.
11. The six coordinates are below.
■X - X coordinate
■Y - Y coordinate
■Z - Z coordinate
■PSI - Psi angle
■THETA - Theta angle
■PHI - Phi angle
You may enter these coordinates in any order. If Adams has to alter the part position to obtain consistent initial conditions, it does not vary the coordinates you specify with this parameter unless Adams must vary them to satisfy the initial conditions you specify for a joint or for a motion.
Cautions:
1. Adams View will not allow you to have two point_masses with the same name, so you must provide a unique name.
Tips:
1. If you type a "?", Adams View will list the parts available by default.