geometry create shape torus
Allows for creation of the torus object.
Format:
geometry create shape torus |
|---|
torus_name = | a new torus |
adams_id = | Adams id |
comments = | string |
center_marker = | an existing marker |
angle_extent = | angle |
major_radius = | length |
minor_radius = | length |
side_count_for_perimeter = | integer |
segment_count = | integer |
Example:
geometry create shape torus & |
|---|
torus_name = | torus__1 & |
comments= | "a new torus" & |
center_marker = | origin & |
angle_extent = | 150 & |
major_radius= | 10 & |
minor_radius = | 5 & |
side_count_for_perimeter = | 10 & |
segment_count = | 10 |
Description:
Parameter | Value Type | Description |
|---|
torus_name | A New Torus | Specifies the name of the new torus |
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. |
major_radius | Length | The parameter is used to specify the radius for the circular spine of the torus. |
minor_radius | Length | The parameter is used to specify the radius for the circular cross-sections of the torus. |
side_count_for_perimeter | Integer | The parameter is used to specify the number of circular cross-sections to create along the spine of the torus. |
segment_count | Integer | The SEGMENT_COUNT parameter is used to specify the number of sides for each of the circular cross-sections of the torus. |
Extended Definition:
1. A torus is defined by a circular spine with a circular cross-section at each point on the spine. The torus is placed at the marker named 'CENTER_MARKER='. The radius for the circular spine of the torus is defined by the MAJOR_RADIUS parameter. The radius for the circular cross-sections is defined by the MINOR_RADIUS parameter. The number of circular cross-sections to create along the spine may be specified with the SIDE_COUNT_FOR_PERIMETER parameter. The number of sides for each of the circular cross-sections may be specified with the SEGMENT_COUNT parameter. The torus will move with the part which owns the center marker.
2. You may use the name specified by the torus_name parameter, later to refer to this torus. Adams View will not allow you to have two tori 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 (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, 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.
3. 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.
4. 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.
5. The angle specified by the angle_extent parameter 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.
Tips:
1. 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.