geometry modify shape cylinder
Allows modification of the cylinder object.
Format:
geometry modify shape cylinder |
|---|
cylinder_name = | an existing cylinder |
new_cylinder_name = | a new cylinder |
adams_id = | adams_id |
comments = | string |
center_marker = | an existing marker |
angle_extent = | angle |
length = | length |
radius = | length |
ref_radius_by_marker = | an existing marker |
side_count_for_body = | integer |
segment_count_for_ends = | integer |
Example:
geometry modify shape cylinder & |
|---|
cylinder_name = | CYLINDER__1 & |
new_cylinder_name = | CYLINDER__2 & |
center_marker = | MARKER_82 & |
angle_extent = | 60 & |
length = | 25 & |
ref_radius_by_marker = | MARKER_72 |
Description:
Parameter | Value Type | Description |
|---|
cylinder_name | An Existing Cylinder | Specifies the cylinder to modify |
new_cylinder_name | A New Cylinder | A NEW CYLINDER |
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. |
center_marker | An Existing Marker | Specifies the marker at the center of a circle, an arc, the bottom of a cylinder, or the bottom of a frustum |
angle_extent | Angle | Specifies a subtended angle measured positive (according to the right-hand rule) about the z-axis of the center marker. |
length | Length | Specifies the height of a cylinder or a frustum. |
Radius | Length | Specifies the radius of a circle, an arc, or a cylinder. |
ref_radius_by_marker | An Existing Marker | Specifies the radius of a circle, an arc, or a cylinder to be the distance from the center marker Z axis to this radius marker. |
side_count_for_body | Integer | Specifies the number of flat sides Adams View draws on a cylinder or a frustum. |
segment_count_for_ends | Integer | Specifies the number of straight line segments Adams View uses to draw the circles at the ends of a cylinder or a frustum. |
Extended Definition:
1. A cylinder is an extruded circle whose top and bottom are perpendicular to the cylinder central axis. The cylinder is placed at the marker named 'CENTER_MARKER='. The circles at the top and at the bottom of the cylinder have a radius specified by a radius, or radius reference marker. The cylinder length is along the the positive z-axis of the center marker, and is specified by 'LENGTH='. The number of sides can be chosen using the 'SIDE_COUNT_FOR_BODY' parameter. The number of edges on the end circles can be specified using the 'SEGMENT_COUNT_FOR_END=' parameter. The cylinder will move with the part who owns the center marker.
2. Specifies the cylinder to modify. You use this parameter to identify the existing cylinder to affect with this command.
You may identify a cylinder by typing its name or by picking it from the screen.
If the cylinder is not visible on the screen, you must type the name.You may also find it convenient to type the name even if the cylinder is displayed.
If you created the cylinder by reading an Adams data set or graphics file, the cylinder name is the letters CYL followed by the Adams data set cylinder ID number. The name of Adams GRAPHIC/101, CYLINDER is CYL101, for example, If you created the cylinder during preprocessing, you gave it a name at that time.
If a cylinder 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 cylinder under a different part, for instance, you may need to enter the part and model names as well. For example, you may specify cylinder 'rod' on part 'arm' in model 'test' by entering ".test.arm.rod". If you type a "?", Adams View will list the cylinders available by default.
You must separate multiple cylinder names by commas.
If the cylinder is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
3. Specifies the name of the new cylinder. You may use this name later to refer to this cylinder. Adams View will not allow you to have two cylinders with the same full name, so you must provide a unique name.
Normally, entity names 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"
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. If you are creating a circle or an arc, orient the center marker so that its z-axis is normal to the plane of the circle or to the plane of the arc. Similarly, if you are defining a cylinder or a frustum, orient the center marker so that its z-axis is normal to the bottom of the cylinder or the frustum.
7. The angle starts at the positive x-axis of the center marker and subtends the arc, the arc of the cylinder, or the arc of the cone frustum.
8. Because the two circles at the ends of a cylinder or a frustum are both perpendicular to the z-axis of the center marker, they are parallel. Adams View uses the value of LENGTH to specify the z distance between the two circles. A positive value specifies a cylinder or a frustum along the positive z-axis of the center marker, and a negative value specifies a cylinder or a frustum along the negative z-axis of the center marker.
9. Adams View stores the radius value, not the marker name. If you later move this marker, the radius will not change.
Cautions:
1. You need not separate multiple cylinder picks by commas.