Adams Basic Package > Adams View > View Command Language > geometry > geometry create shape blockgeometry create shape cylinder

geometry create shape block

Allows for creation of the block object.

Format:

 
geometry create shape block
block_name =
a new block
adams_id =
adams_id
comments =
string
corner_marker =
an existing marker
diag_corner_coords =
length

Example:

 
geometry create shape block &
block_name =
box__1 &
corner_marker =
marker_82 &
diag_corner_coords =
2,4,6

Description:

 
Parameter
Value Type
Description
block_name
A New Block
Specifies the name of the new block.
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.
corner_marker
An Existing Marker
Specifies the marker that defines the anchor point for the definition of a block.
diag_corner_coords
Length
Specifies the location (x, y, z) of the opposite diagonal corner from the corner_marker for a block. These coordinates are with respect to the corner marker x, y, and z axes. This location, along with the corner_marker, define the boundaries of the block.

Extended Definition:

1. A block is a box with parallel edges and orthogonal vertices. You position and orient a block by means of a corner marker. You specify the dimensions of the box by supplying three coordinates for the opposite corner.
2. Specifies the name of the new block. You may use this name later to refer to this block. Adams View will not allow you to have two blocks 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"
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.
5. These coordinates are with respect to the corner marker x, y, and z axes. This location, along with the corner_marker, define the boundaries of the block.

geometry create shape cylinder

Allows for creation of the cylinder object.

Format:

 
geometry create shape cylinder
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 create shape cylinder &
cylinder_name =
CYLINDER__1 &
center_marker =
MARKER_82 &
angle_extent =
60 &
length =
25 &
ref_radius_by_marker =
MARKER_72

Description:

 
Parameter
Value Type
Description
cylinder_name
A New Cylinder
Specifies the name of the 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 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 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 (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"
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. 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.
6. 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.
7. 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.
8. Adams View stores the radius value, not the marker name. If you later move this marker, the radius will not change.

Cautions:

1. cylinder_name: The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.

geometry create shape ellipsoid

Allows for creation of the ellipsoid object.

Format:

 
geometry create shape ellipsoid
ellipsoid_name =
a new ellipsoid
comments =
string
center_marker =
an existing marker
x_scale_factor =
length
y_scale_factor =
length
z_scale_factor =
length

Example:

 
geometry create shape ellipsoid &
ellipsoid_name =
ELLIPSOID__1 &
center_marker =
MARKER_74 &
x_scale_factor =
2

Description:

 
Parameter
Value Type
Description
ellipsoid_name
A New Ellipsoid
Specifies the name of the new ellipsoid
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
x_scale_factor
Length
The X_SCALE_FACTOR parameter is used to specify the scaling of the initial unit sphere along the center marker's x axis.
y_scale_factor
Length
The Y_SCALE_FACTOR parameter is used to specify the scaling of the initial unit sphere along the center marker's y axis.
z_scale_factor
Length
The Z_SCALE_FACTOR parameter is used to specify the scaling of the initial unit sphere along the center marker's z axis.

Extended Definition:

1. An ellipsoid is a unit sphere that has been scaled in the x, y, and z directions. The ellipsoid is placed at the marker named 'CENTER_MARKER='. The X_SCALE_FACTOR, Y_SCALE_FACTOR, and Z_SCALE_FACTOR parameters are used to specify the scaling of the initial unit sphere along the center marker's x, y, z axes. The ellipsoid will move with the part which owns the center marker.
2. Specifies the name of the new ellipsoid. You may use this name later to refer to this ellipsoid. Adams View will not allow you to have two ellipsoids 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. Specifies the marker at the center of a circle, an arc, the bottom of a cylinder, or the bottom of a frustum. 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.