marker create
Allows you to create a marker. You may reverse this creation at a later time with an UNDO command.
Format:
marker create |
|---|
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 create & |
|---|
marker_name = | marker__1 & |
adams_id = | 1 & |
comments = | "a new 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 | 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). The parameter is mutually exclusive with the 'node_id' parameter, for marker creation. |
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.
OR
Specifies a node_label on an FE Part that Adams View will use to determine the location at which it will place a marker. If a location is also specified, then the node referenced here will be ignored, the location field contents will determine the marker location and the marker will be associated with the nearest node. |
offset | Location | Specifies the translational offset from the specified FE part node at which the marker is to be created. Offset is used only in conjunction with an FE Part node. These coordinates are relative to the FE Part node's coordinate system (X tangent to centerline, Y and Z are normal and binormal). |
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. Markers are attached to parts, which are contained in models. Before creating markers, you must use the 'MODEL CREATE' and 'PART CREATE RIGID_BODY NAME_AND_POSITION' command to create at least one model and part.
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 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.
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 is mutually exclusive with the node_id parameter for the marker create command.
7. The 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 paramater. If you enter one location, the axis will point towards 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 parameter. If you enter two locations, the axis will point towards 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.