marker modify

Allows you to modify an existing marker.

Format:

 
marker modify
marker_name =
an existing marker
new_marker_name =
a new marker
adams_id =
adams_id
comments =
string
location =
location
preserve_location =
true_only
node_id =
integer
orientation =
orientation
along_axis_orientation =
location
in_plane_orientation =
location
relative_to =
an existing model, part or marker
curve_name =
an existing curve
velocity =
real
vx =
real
vy =
real
vz =
real
reference_marker_name =
an existing marker

Example:

 
marker modify &
marker_name =
marker__1 &
new_marker_name =
marker__2 &
adams_id =
1 &
comments =
"modifying an existing marker" &
location =
10 , 20 , 10 &
node_id =
5 &
orientation =
10,10,10 &
relative_to =
piston &
reference_marker_name =
marker_33

Description:

 
Parameter
Value Type
Description
marker_name
 
new_marker_name
A New Marker
Specifies the name of the new marker. You may use this name later to refer to this marker.
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.
location
Location
Specifies the location of the origin of a coordinate system (for example, marker or part).
preserve_location
True only
An optional parameter, which when specified means that the marker location is to be retained as specified (for example, marker on a flexible body will not be snapped to the nearest node).
node_id
Integer
Specifies a node_id on a flexible body that Adams view will use to determine the location at which it will place a marker.
orientation
Orientation
Specifies the orientation of a coordinate system (for example, marker or part) using three rotation angles.
along_axis_orientation
Location
Specifies the orientation of a coordinate system (for example, 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 (for example, marker or part) by directing one of the axes and locating one of the coordinate planes.
relative_to
An Existing Model, Part OR Marker
Specifies the coordinate system that location coordinates and orientation angles correspond to.
curve_name
An existing Curve
Specifies the curve name on which to create a marker
velocity
Real
Specifies the initial conditions
vx
Real
Specifies the initial conditions
vy
Real
Specifies the initial conditions
vz
Real
Specifies the initial conditions
reference_marker_name
An Existing Marker
Specifies an existing marker which acts as a reference

Extended Definition:

1. You may identify a marker by typing its name or by picking it from the screen.
If the marker is not visible on the screen, you must type the name.
You may also find it convenient to type the name even if the marker is displayed.
If you created the marker by reading an Adams data set or graphics file, the marker name is the letters MAR followed by the Adams data set marker ID number. For example, the name of Adams MARKER/101 is MAR101. If you created the marker during preprocessing, you will have given it a name at that time.
If a marker is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. To identify a marker under a different part, for instance, you may need to enter the model and part names as well. For example, you may specify marker 'pivot' from model 'links', part 'lower_arm' by entering ".links.lower_arm.pivot". If you type a "?", Adams View will list the markers available by default.
You must separate multiple marker names by commas. If the marker is visible in one of your views, you may identify it by picking on it. You need not separate multiple marker picks by commas.
2. 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 (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 override 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.
3. 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.
4. When an Adams Solver data file (.adm) is read into AdamsAdams 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.
5. 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.
6. The preserve_location parameter is specified to indicate that the specified marker location is to be preserved. The parameter comes into play for markers on a flex body or on an external system (where an MNF/MD DB is specified). For example, a flex marker will not be snapped to the node nearest to the specified location, if this parameter is specified.
This parameter can be specified with the node_id parameter during marker modification, to indicate that the marker is NOT to be snapped to the nearest node, but instead its existing location is to be maintained.
for example, marker create marker = .model_1.flex_body_1.marker_1 node_id = 15 location = 10,10,10
marker modify marker = .model_1.flex_body_1.marker_1 node_id = 20 preserve_location = true
The modify marker command will change the node_id of the marker to 20 and its original location (10,10,10) will be maintained.
7. The node_id value must be an integer which is a valid node ID from your flexible element model.
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 to direct the axis using the along_axis_orientation parameter. 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.  You may enter either two or three locations for the in_plane_orientation paramater. If you enter two locations, the axis will point toward the first location and the plane will fall on the second. If you specify three locations, the axis will be parallel to, and pointing the same way as the vector from the first location to the second and the plane will be parallel to the plane defined by the three locations.
By default, you direct the Z axis of the coordinate system and locate the ZX plane. You may use the 'DEFAULTS ORIENT_AXIS_AND_PLANE AXIS_AND_PLANE_SETTING=' command to change this convention. For example, selecting X_AXIS_XY_PLANE means you will subsequently be directing the X axis and locating the XY plane.
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.
11.  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.

Cautions:

Adams View will not allow you to have two markers with the same name, so you must provide a unique name.

Tips:

1. You must enter the name of the marker you wish to modify by either picking it from the screen or specifying the full name.
2. You may reverse this modification at a later time with an UNDO command.