Adams Basic Package > Adams View > View Command Language > force > force create body gravitational

force create body gravitational

Allows you to create a gravitational body object.

Format:

 
force create body gravitational
gravity_field_name =
new_grav_field_na,e
comments =
string
units_consistency_factor =
real_number
x_component_gravity =
real_number
y_component_gravity =
real_number
z_component_gravity =
real_number

Example:

 
force create body gravitational &
gravity_field_name =
ACCGRAV__1 &
comments =
“” &
units_consistency_factor =
0 &
x_component_gravity =
0.8 &
y_component_gravity =
0.8 &
z_component_gravity =
0.7

Description:

 
Parameter
Value Type
Description
gravity_field_name
String
Specifies the name of the new gravity field.
Comments
String
Specifies comments for the object being created or modified.
units_consistency_factor
Real
Specifies a conversion factor to make your force, mass, length, and time units consistent
x_component_gravity
Real
Specifies the x component of gravitational acceleration with respect to the ground reference frame.
y_component_gravity
Real
Specifies the y component of gravitational acceleration with respect to the ground reference frame.
z_component_gravity
Real
Specifies the z component of gravitational acceleration with respect to the ground reference frame.

Extended Definition:

1. In conjunction with the part masses, the gravitational field defines a body force at the center of gravity of each part. The force direction is defined by the X_COMPONENT_GRAVITY, Y_COMPONENT_GRAVITY, and Z_COMPONENT_GRAVITY parameters. The force magnitude is the part mass multiplied by the magnitude of the gravity vector. Each gravity field is written as an Adams ACCGRAV statement. Although Adams View allows you to create more than one gravity field, you should only use one, since Adams only allows one ACCGRAV statement. You may also specify UNITS_CONSISTENCY_FACTOR in a gravity field. Adams View writes this as the GC parameter in the ACCGRAV statement. Although UNITS_CONSISTENCY_FACTOR affects the reporting of all forces, not just gravitational, it is included here because it also appears in the ACCGRAV statement.
2. You may use the gracity_field_name name later to refer to this gravity field. Adams View will not allow you to have two gravity fields with the same 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. For more information, see Using Extended Names. They may be of any length. 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. You may select any force, mass, length, or time units you wish. In order for Adams results to be meaningful, however, you or Adams View must compute a factor such that the equation Force = (Mass / UNITS_CONSISTENCY_FACTOR) * Acceleration is satisfied. For example, if you use Newtons, kilograms, millimeters, and seconds, UNITS_CONSISTENCY_FACTOR is 1000. Adams documentation and Data Set Language refer to this factor as GC, on the ACCGRAV card. The only case in which you should set UNITS_CONSISTENCY_FACTOR yourself is when you are using a set of units Adams View does not support. Otherwise, you should probably let Adams View compute it for you. If you do use this command to set UNITS_CONSISTENCY_FACTOR to a non-zero value, Adams View will write your value to an Adams data set. Adams View will not change your value, even if you later change your force, mass, length, or time units. If you explicitly set UNITS_CONSISTENCY_FACTOR, and then later change your units, remember to updateUNITS_CONSISTENCY_FACTOR.

Tips:

If you do not specify UNITS_CONSISTENCY_FACTOR, or specify it as zero, Adams View will calculate it for you when it writes the Adams data set.